HTMLVideoElement
interface provides special properties and methods for manipulating video objects. It also inherits properties and methods of HTMLMediaElement
and HTMLElement
.Is a string
that reflects the height
HTML attribute, which specifies the height of the display area, in CSS pixels.
Promise<number>
Is a string
that reflects the poster
HTML attribute, which specifies an image to show while no video data is available.
Promise<string>
Returns an unsigned integer value indicating the intrinsic height of the resource in CSS pixels, or 0 if no media is available yet.
Promise<number>
Returns an unsigned integer value indicating the intrinsic width of the resource in CSS pixels, or 0 if no media is available yet.
Promise<number>
Is a string
that reflects the width
HTML attribute, which specifies the width of the display area, in CSS pixels.
Promise<number>
A AudioTrackList
that lists the AudioTrack
objects contained in the element.
AudioTrackList
A `boolean` that reflects the autoplay
HTML attribute, indicating whether playback should automatically begin as soon as enough media is available to do so without interruption.
Promise<boolean>
Returns a TimeRanges
object that indicates the ranges of the media source that the browser has buffered (if any) at the moment the buffered
property is accessed.
TimeRanges
Is a boolean
that reflects the controls
HTML attribute, indicating whether user interface items for controlling the resource should be displayed.
Promise<boolean>
Returns a DOMTokenList
that helps the user agent select what controls to show on the media element whenever the user agent shows its own set of controls. The DOMTokenList
takes one or more of three possible values: nodownload
, nofullscreen
, and noremoteplayback
.
DOMTokenList
A string
indicating the CORS setting for this media element.
Promise<string>
Returns a string
with the absolute URL of the chosen media resource.
Promise<string>
A double-precision floating-point value indicating the current playback time in seconds; if the media has not started to play and has not been seeked, this value is the media's initial playback time. Setting this value seeks the media to the new time. The time is specified relative to the media's timeline.
Promise<number>
A boolean
that reflects the muted
HTML attribute, which indicates whether the media element's audio output should be muted by default.
Promise<boolean>
A double
indicating the default playback rate for the media.
Promise<number>
A boolean
that sets or returns the remote playback state, indicating whether the media element is allowed to have a remote playback UI.
Promise<boolean>
A read-only double-precision floating-point value indicating the total duration of the media in seconds. If no media data is available, the returned value is NaN
. If the media is of indefinite length (such as streamed live media, a WebRTC call's media, or similar), the value is +Infinity
.
Promise<number>
Returns a boolean
that indicates whether the media element has finished playing.
Promise<boolean>
Returns a MediaError
object for the most recent error, or null
if there has not been an error.
MediaError
A boolean
that reflects the loop
HTML attribute, which indicates whether the media element should start over when it reaches the end.
Promise<boolean>
Returns a MediaKeys
object or null
. MediaKeys is a set of keys that an associated HTMLMediaElement can use for decryption of media data during playback.
MediaKeys
Is a boolean
that determines whether audio is muted. true
if the audio is muted and false
otherwise.
Promise<boolean>
Returns a unsigned short
(enumeration) indicating the current state of fetching the media over the network.
Promise<number>
Is a double
that indicates the rate at which the media is being played back.
Promise<number>
Returns a TimeRanges
object that contains the ranges of the media source that the browser has played, if any.
TimeRanges
Is a string
that reflects the preload
HTML attribute, indicating what data should be preloaded, if any. Possible values are: none
, metadata
, auto
.
Promise<string>
Returns a unsigned short
(enumeration) indicating the readiness state of the media.
Promise<number>
Returns a TimeRanges
object that contains the time ranges that the user is able to seek to, if any.
TimeRanges
Returns a boolean
that indicates whether the media is in the process of seeking to a new position.
Promise<boolean>
Returns a string
that is the unique ID of the audio device delivering output, or an empty string if it is using the user agent default. This ID should be one of the MediaDeviceInfo.deviceid
values returned from MediaDevices.enumerateDevices()
, id-multimedia
, or id-communications
.
Promise<string>
Is a string
that reflects the src
HTML attribute, which contains the URL of a media resource to use.
Promise<string>
Returns the list of TextTrack
objects contained in the element.
TextTrackList
Returns the list of VideoTrack
objects contained in the element.
VideoTrackList
Is a double
indicating the audio volume, from 0.0 (silent) to 1.0 (loudest).
Promise<number>
Is a string
representing the access key assigned to the element.
Promise<string>
Needs content.
Promise<string>
Is a string
, reflecting the dir
global attribute, representing the directionality of the element. Possible values are "ltr"
, "rtl"
, and "auto"
.
Promise<string>
Is a boolean
indicating if the element can be dragged.
Promise<boolean>
Is a boolean
indicating if the element is hidden or not.
Promise<boolean>
Is a boolean
indicating whether the user agent must act as though the given node is absent for the purposes of user interaction events, in-page text searches ("find in page"), and text selection.
Promise<boolean>
Represents the "rendered" text content of a node and its descendants. As a getter, it approximates the text the user would get if they highlighted the contents of the element with the cursor and then copied it to the clipboard.
Promise<string>
Is a string
representing the language of an element's attributes, text, and element contents.
Promise<string>
Returns a double
containing the height of an element, relative to the layout.
Promise<number>
Returns a double
, the distance from this element's left border to its offsetParent
's left border.
Promise<number>
Returns a Element
that is the element from which all offset calculations are currently computed.
SuperElement
Returns a double
, the distance from this element's top border to its offsetParent
's top border.
Promise<number>
Returns a double
containing the width of an element, relative to the layout.
Promise<number>
Is a boolean
that controls spell-checking. It is present on all HTML elements, though it doesn't have an effect on all of them.
Promise<boolean>
Is a string
containing the text that appears in a popup box when mouse is over the element.
Promise<string>
Is a boolean
representing the translation.
Promise<boolean>
Returns a NamedNodeMap
object containing the assigned attributes of the corresponding HTML element.
NamedNodeMap
Returns a DOMTokenList
containing the list of class attributes.
DOMTokenList
Is a string
representing the class of the element.
Promise<string>
Returns a number
representing the inner height of the element.
Promise<number>
Returns a number
representing the width of the left border of the element.
Promise<number>
Returns a number
representing the width of the top border of the element.
Promise<number>
Returns a number
representing the inner width of the element.
Promise<number>
Is a string
representing the id of the element.
Promise<string>
Is a string
representing the markup of the element's content.
Promise<string>
A string
representing the local part of the qualified name of the element.
Promise<string>
The namespace URI of the element, or null
if it is no namespace.
Note: In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the http://www.w3.org/1999/xhtml
namespace in both HTML and XML trees.
Promise<string>
Is a string
representing the markup of the element including its content. When used as a setter, replaces the element with nodes parsed from the given string.
Promise<string>
Represents the part identifier(s) of the element (i.e. set using the part
attribute), returned as a DOMTokenList
.
DOMTokenList
A string
representing the namespace prefix of the element, or null
if no prefix is specified.
Promise<string>
Returns a number
representing the scroll view height of an element.
Promise<number>
Is a number
representing the left scroll offset of the element.
Promise<number>
A number
representing number of pixels the top of the document is scrolled vertically.
Promise<number>
Returns a number
representing the scroll view width of the element.
Promise<number>
Returns the open shadow root that is hosted by the element, or null if no open shadow root is present.
ShadowRoot
Returns the name of the shadow DOM slot the element is inserted in.
Promise<string>
Returns a String
with the name of the tag for the given element.
Promise<string>
Returns a string
representing the base URL of the document containing the Node
.
Promise<string>
Returns a live NodeList
containing all the children of this node. NodeList
being live means that if the children of the Node
change, the NodeList
object is automatically updated.
SuperNodeList
Returns a Node
representing the first direct child node of the node, or null
if the node has no child.
SuperNode
A boolean indicating whether or not the Node is connected (directly or indirectly) to the context object, e.g. the Document
object in the case of the normal DOM, or the ShadowRoot
in the case of a shadow DOM.
Promise<boolean>
Returns a Node
representing the last direct child node of the node, or null
if the node has no child.
SuperNode
Returns a Node
representing the next node in the tree, or null
if there isn't such node.
SuperNode
Returns a string
containing the name of the Node
. The structure of the name will differ with the node type. E.g. An HTMLElement
will contain the name of the corresponding tag, like 'audio'
for an HTMLAudioElement
, a Text
node will have the '#text'
string, or a Document
node will have the '#document'
string.
Promise<string>
Returns an unsigned short
representing the type of the node. Possible values are:
Name Value ELEMENT_NODE
1
ATTRIBUTE_NODE
2
TEXT_NODE
3
CDATA_SECTION_NODE
4
ENTITY_REFERENCE_NODE
5
ENTITY_NODE
6
PROCESSING_INSTRUCTION_NODE
7
COMMENT_NODE
8
DOCUMENT_NODE
9
DOCUMENT_TYPE_NODE
10
DOCUMENT_FRAGMENT_NODE
11
NOTATION_NODE
12
Promise<number>
Returns / Sets the value of the current node.
Promise<string>
Returns the Document
that this node belongs to. If the node is itself a document, returns null
.
SuperDocument
Returns an Element
that is the parent of this node. If the node has no parent, or if that parent is not an Element
, this property returns null
.
SuperElement
Returns a Node
that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returns null
.
SuperNode
Returns a Node
representing the previous node in the tree, or null
if there isn't such node.
SuperNode
Returns / Sets the textual content of an element and all its descendants.
Promise<string>
The style
property is used to get as well as set the inline style of an element. When getting, it returns a CSSStyleDeclaration
object that contains a list of all styles properties for that element with values assigned for the attributes that are defined in the element's inline style
attribute.
CSSStyleDeclaration
Needs content.
Promise<string>
Needs content.
Promise<boolean>
Needs content.
Promise<Record<string, string>>
Needs content.
Promise<string>
Needs content.
Promise<number>
Returns the Element
immediately following this node in its parent's children list, or null
if there is no Element
in the list following this node.
SuperElement
Returns the Element
immediately prior to this node in its parent's children list, or null
if there is no Element
in the list prior to this node.
SuperElement
Returns the number of children of this ParentNode
which are elements.
Promise<number>
Returns a live HTMLCollection
containing all of the Element
objects that are children of this ParentNode
, omitting all of its non-element nodes.
SuperHTMLCollection
Returns the first node which is both a child of this ParentNode
and is also an Element
, or null
if there is none.
SuperElement
Returns the last node which is both a child of this ParentNode
and is an Element
, or null
if there is none.
SuperElement
Returns the <slot>
the node is inserted in.
HTMLSlotElement
Returns a VideoPlaybackQuality
object that contains the current playback metrics. This information includes things like the number of dropped or corrupted frames, as well as the total number of frames.
VideoPlaybackQuality
Given a string specifying a MIME media type (potentially with the codecs
parameter included), canPlayType()
returns the string probably
if the media should be playable, maybe
if there's not enough information to determine whether the media will play or not, or an empty string if the media cannot be played.
string
. A string
containing the MIME type of the media.Promise<CanPlayTypeResult>
Returns MediaStream
, captures a stream of the media content.
MediaStream
Resets the media to the beginning and selects the best available source from the sources provided using the src
attribute or the <source>
element.
Promise<void>
Pauses the media playback.
Promise<void>
Begins playback of the media.
Promise<void>
Sets the ID of the audio device to use for output and returns a Promise
. This only works when the application is authorized to use the specified device.
string
. The MediaDeviceInfo.deviceId
of the audio output device.Promise<void>
Sends a mouse click event to the element.
Promise<void>
Returns the Element
which is the closest ancestor of the current element (or the current element itself) which matches the selectors given in parameter.
string
. selectors
is a string
containing a selector list.p:hover, .toto + q
SuperElement
Retrieves the value of the named attribute from the current node and returns it as an Object
.
string
. attributeName
is the name of the attribute whose value you want to get.Promise<string>
Returns an array of attribute names from the current element.
Promise<Iterable,string>
Retrieves the node representation of the named attribute from the current node and returns it as an Attr
.
string
. attrName
is a string containing the name of the attribute.Promise<Attr>
Retrieves the node representation of the attribute with the specified name and namespace, from the current node and returns it as an Attr
.
string
. namespace
is a string specifying the namespace of the attribute.string
. nodeName
is a string specifying the name of the attribute.Promise<Attr>
Retrieves the value of the attribute with the specified name and namespace, from the current node and returns it as an Object
.
string
. The namespace in which to look for the specified attribute.string
. The name of the attribute to look for.Promise<string>
Returns the size of an element and its position relative to the viewport.
Promise<DOMRect>
Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.
Promise<DOMRectList>
Returns a live HTMLCollection
that contains all descendants of the current element that possess the list of classes given in the parameter.
string
. A string
containing one or more class names to match on, separated by whitespace.SuperHTMLCollection
Returns a live HTMLCollection
containing all descendant elements, of a particular tag name, from the current element.
string
. tagName
is the qualified name to look for. The special string "*"
represents all elements. For compatibility with XHTML, lower-case should be used.SuperHTMLCollection
Returns a live HTMLCollection
containing all descendant elements, of a particular tag name and namespace, from the current element.
string
. namespaceURI
is the namespace URI of elements to look for (see Element.namespaceURI
and Attr.namespaceURI
). For example, if you need to look for XHTML elements, use the XHTML namespace URI, http://www.w3.org/1999/xhtml
.string
. localName
is either the local name of elements to look for or the special value "*"
, which matches all elements (see Element.localName
and Attr.localName
).SuperHTMLCollection
Returns a boolean
indicating if the element has the specified attribute or not.
string
. is a string representing the name of the attribute.Promise<boolean>
Returns a boolean
indicating if the element has the specified attribute, in the specified namespace, or not.
string
. namespace
is a string specifying the namespace of the attribute.string
. localName
is the name of the attribute.Promise<boolean>
Returns a boolean
indicating if the element has one or more HTML attributes present.
Promise<boolean>
Indicates whether the element on which it is invoked has pointer capture for the pointer identified by the given pointer ID.
number
. The pointerId
of a PointerEvent
object.Promise<boolean>
Returns a boolean
indicating whether or not the element would be selected by the specified selector string.
string
. selectorString
is a string representing the selector to test.Promise<boolean>
Asynchronously asks the browser to make the element full-screen.
FullscreenOptions
. A FullscreenOptions
object providing options that control the behavior of the transition to full-screen mode. Currently, the only option is navigationUI
, which controls whether or not to show navigation UI while the element is in full-screen mode. The default value is "auto"
, which indicates that the browser should decide what to do.Promise<void>
Allows to asynchronously ask for the pointer to be locked on the given element.
Promise<void>
Scrolls the page until the element gets into the view.
boolean | ScrollIntoViewOptions
boolean
value: true
, the top of the element will be aligned to the top of the visible area of the scrollable ancestor. Corresponds to scrollIntoViewOptions: {block: "start", inline: "nearest"}
. This is the default value.false
, the bottom of the element will be aligned to the bottom of the visible area of the scrollable ancestor. Corresponds to scrollIntoViewOptions: {block: "end", inline: "nearest"}
.behavior
Optionalauto
or smooth
. Defaults to auto
.block
Optionalstart
, center
, end
, or nearest
. Defaults to start
.inline
Optionalstart
, center
, end
, or nearest
. Defaults to nearest
.Promise<void>
Compares the position of the current node against another node in any other document.
Node
. The other Node
with which to compare the first node
’s document position.Promise<number>
Returns a boolean
value indicating whether or not a node is a descendant of the calling node.
Node
. Needs content.Promise<boolean>
Returns the context object's root which optionally includes the shadow root if it is available.
GetRootNodeOptions
. An object that sets options for getting the root node. The available options are: composed
: A `boolean` that indicates whether the shadow root should be returned (false
, the default), or a root node beyond shadow root (true
).SuperNode
Returns a boolean
indicating whether or not the element has any child nodes.
Promise<boolean>
Accepts a namespace URI as an argument and returns a boolean
with a value of true
if the namespace is the default namespace on the given node or false
if not.
string
. namespaceURI
is a string representing the namespace against which the element will be checked.Promise<boolean>
Returns a boolean
which indicates whether or not two nodes are of the same type and all their defining data points match.
Node
. otherNode
: The Node
to compare equality with.Promise<boolean>
Returns a boolean
value indicating whether or not the two nodes are the same (that is, they reference the same object).
Node
. otherNode
The Node
to test against.Promise<boolean>
Accepts a prefix and returns the namespace URI associated with it on the given node if found (and null
if not). Supplying null
for the prefix will return the default namespace.
string
. The prefix to look for. If this parameter is null
, the method will return the default namespace URI, if any.Promise<string>
Returns a string
containing the prefix for a given namespace URI, if present, and null
if not. When multiple prefixes are possible, the result is implementation-dependent.
string
. Needs content.Promise<string>
Clean up all the text nodes under this element (merge adjacent, remove empty).
Promise<void>
Needs content.
Promise<void>
Needs content.
Promise<void>
Returns the first Element
with the current element as root that matches the specified group of selectors.
string
. A string
containing one or more selectors to match against. This string must be a valid compound selector list supported by the browser; if it's not, a SyntaxError
exception is thrown. See Locating DOM elements using selectors for more information about using selectors to identify elements. Multiple selectors may be specified by separating them using commas.SuperElement
Returns a NodeList
representing a list of elements with the current element as root that matches the specified group of selectors.
string
. A string
containing one or more selectors to match against. This string must be a valid CSS selector string; if it's not, a SyntaxError
exception is thrown. See Locating DOM elements using selectors for more information about using selectors to identify elements. Multiple selectors may be specified by separating them using commas.SuperNodeList
onencrypted | onwaitingforkey |
paused | onfullscreenchange |
onfullscreenerror | oncopy |
oncut | onpaste |
onabort | onanimationend |
onanimationiteration | onanimationstart |
onauxclick | onblur |
oncancel | oncanplay |
oncanplaythrough | onchange |
onclick | onclose |
oncontextmenu | oncuechange |
ondblclick | ondrag |
ondragend | ondragenter |
ondragleave | ondragover |
ondragstart | ondrop |
ondurationchange | onemptied |
onended | onerror |
onfocus | onformdata |
ongotpointercapture | oninput |
oninvalid | onkeydown |
onkeypress | onkeyup |
onload | onloadeddata |
onloadedmetadata | onloadstart |
onlostpointercapture | onmousedown |
onmouseenter | onmouseleave |
onmousemove | onmouseout |
onmouseover | onmouseup |
onpause | onplay |
onplaying | onpointercancel |
onpointerdown | onpointerenter |
onpointerleave | onpointermove |
onpointerout | onpointerover |
onpointerup | onprogress |
onratechange | onreset |
onresize | onscroll |
onseeked | onseeking |
onselect | onselectionchange |
onselectstart | onstalled |
onsubmit | onsuspend |
ontimeupdate | ontouchcancel |
ontouchend | ontouchmove |
ontouchstart | ontransitionend |
onvolumechange | onwaiting |
onwheel |
addTextTrack() | setMediaKeys() |
attachShadow() | computedStyleMap() |
insertAdjacentElement() | insertAdjacentHTML() |
insertAdjacentText() | releasePointerCapture() |
removeAttribute() | removeAttributeNode() |
removeAttributeNS() | scroll() |
scrollBy() | scrollTo() |
setAttribute() | setAttributeNode() |
setAttributeNodeNS() | setAttributeNS() |
setPointerCapture() | toggleAttribute() |
appendChild() | cloneNode() |
insertBefore() | removeChild() |
replaceChild() | addEventListener() |
dispatchEvent() | removeEventListener() |
animate() | getAnimations() |
after() | before() |
remove() | replaceWith() |
append() | prepend() |