HTMLVideoElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨July 2015⁩.

* Some parts of this feature may have varying levels of support.

Implemented by the<video> element, theHTMLVideoElement interface provides special properties and methods for manipulating video objects. It also inherits properties and methods ofHTMLMediaElement andHTMLElement.

The list ofsupported media formats varies from one browser to the other. You should either provide your video in a single format that all the relevant browsers supports, or provide multiple video sources in enough different formats that all the browsers you need to support are covered.

Instance properties

Inherits properties from its parent interface,HTMLMediaElement, andHTMLElement.

HTMLVideoElement.disablePictureInPicture: Indicates if the user agent should suggest the picture-in-picture to users, or not.
HTMLVideoElement.height: A string that reflects theheight HTML attribute, which specifies the height of the display area, in CSS pixels.
HTMLVideoElement.poster: A string that reflects theposter HTML attribute, which specifies an image to show while no video data is available.
HTMLVideoElement.videoHeightRead only: Returns an unsigned integer value indicating the intrinsic height of the resource in CSS pixels, or 0 if no media is available yet.
HTMLVideoElement.videoWidthRead only: Returns an unsigned integer value indicating the intrinsic width of the resource in CSS pixels, or 0 if no media is available yet.
HTMLVideoElement.width: A string that reflects thewidth HTML attribute, which specifies the width of the display area, in CSS pixels.

Firefox-specific properties

HTMLVideoElement.mozParsedFramesNon-standardRead only Deprecated: Returns anunsigned long with the count of video frames that have been parsed from the media resource.
HTMLVideoElement.mozDecodedFramesNon-standardRead only Deprecated: Returns anunsigned long with the count of parsed video frames that have been decoded into images.
HTMLVideoElement.mozPresentedFramesNon-standardRead only Deprecated: Returns anunsigned long with the count of decoded frames that have been presented to the rendering pipeline for painting.
HTMLVideoElement.mozPaintedFramesNon-standardRead only Deprecated: Returns anunsigned long with the count of presented frames which were painted on the screen.
HTMLVideoElement.mozFrameDelayNon-standardRead only Deprecated: Returns adouble with the time which the last painted video frame was late by, in seconds.
HTMLVideoElement.mozHasAudioNon-standardRead only Deprecated: Returns a boolean indicating if there is some audio associated with the video.

Instance methods

Inherits methods from its parent interface,HTMLMediaElement, andHTMLElement.

HTMLVideoElement.cancelVideoFrameCallback(): Cancels a previously-registered video frame callback (seerequestVideoFrameCallback()).
HTMLVideoElement.getVideoPlaybackQuality(): Returns aVideoPlaybackQuality 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.
HTMLVideoElement.requestPictureInPicture(): Requests that the user agent enters the video into picture-in-picture mode.
HTMLVideoElement.requestVideoFrameCallback(): Registers a callback function that runs when a new video frame is sent to the compositor. This enables developers to perform efficient operations on each video frame.

Events

Inherits events from its parent interface,HTMLMediaElement, andHTMLElement.

Listen to these events usingaddEventListener() or by assigning an event listener to theoneventname property of this interface.

enterpictureinpicture: Fired when theHTMLVideoElement enters picture-in-picture mode successfully.
leavepictureinpicture: Fired when theHTMLVideoElement leaves picture-in-picture mode successfully.
resize: Fires when one or both of thevideoWidth andvideoHeight properties have just been updated.