HTMLMediaElement interface adds to HTMLElement the properties and methods needed to support basic media-related capabilities that are common to audio and video. The HTMLVideoElement and HTMLAudioElement elements both inherit this interface.A AudioTrackList that lists the AudioTrack objects contained in the element.
AudioTrackListA `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.
TimeRangesIs 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.
DOMTokenListA 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.
MediaErrorA 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.
MediaKeysIs 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.
TimeRangesIs 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.
TimeRangesReturns 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.
TextTrackListReturns the list of VideoTrack objects contained in the element.
VideoTrackListIs 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.
SuperElementReturns 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.
NamedNodeMapReturns a DOMTokenList containing the list of class attributes.
DOMTokenListIs 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.
DOMTokenListA 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.
ShadowRootReturns 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.
SuperNodeListReturns a Node representing the first direct child node of the node, or null if the node has no child.
SuperNodeA 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.
SuperNodeReturns a Node representing the next node in the tree, or null if there isn't such node.
SuperNodeReturns 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_NODE1ATTRIBUTE_NODE 2TEXT_NODE3CDATA_SECTION_NODE4ENTITY_REFERENCE_NODE 5ENTITY_NODE 6PROCESSING_INSTRUCTION_NODE7COMMENT_NODE8DOCUMENT_NODE9DOCUMENT_TYPE_NODE10DOCUMENT_FRAGMENT_NODE11NOTATION_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.
SuperDocumentReturns 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.
SuperElementReturns 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.
SuperNodeReturns a Node representing the previous node in the tree, or null if there isn't such node.
SuperNodeReturns / 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.
CSSStyleDeclarationNeeds 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.
SuperElementReturns 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.
SuperElementReturns 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.
SuperHTMLCollectionReturns the first node which is both a child of this ParentNodeand is also an Element, or null if there is none.
SuperElementReturns the last node which is both a child of this ParentNodeand is an Element, or null if there is none.
SuperElementReturns the <slot> the node is inserted in.
HTMLSlotElementGiven 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.
MediaStreamResets 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 + qSuperElementRetrieves 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.SuperHTMLCollectionReturns 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.SuperHTMLCollectionReturns 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).SuperHTMLCollectionReturns 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 | ScrollIntoViewOptionsboolean 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"}.behaviorOptionalauto or smooth. Defaults to auto.blockOptionalstart, center, end, or nearest. Defaults to start.inlineOptionalstart, 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).SuperNodeReturns 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.SuperElementReturns 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.SuperNodeListonencrypted | 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() |