HTMLVideoElement

https://html.spec.whatwg.org/multipage/media.html#htmlmediaelement（仅提供英文版）除了w3c规范中描述的标准事件外，此对象还会发出数量很少的自定义事件。“playbackstarted”：当MediaPlayer开始播放时发送给客户端的事件“audiofocusgranted”：当MediaPlayer在获得音频焦点后于内部恢复播放时发送给客户端的事件。“audiofocuspaused”：当MediaPlayer因暂时失去音频焦点而在内部暂停播放时发送给客户端的事件。“audiofocuslost”：当MediaPlayer因永久失去音频焦点而在内部暂停播放时发送给客户端的事件。

扩展

• HTMLMediaElement

构造函数

new HTMLVideoElement()

new HTMLVideoElement(): HTMLVideoElement

返回值

HTMLVideoElement

继承自

HTMLMediaElement.constructor

属性

audioTracks

abstract readonly audioTracks: AudioTrackList

获取音频轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-audiotracks。

继承自

HTMLMediaElement.audioTracks

---

autoplay

abstract autoplay: boolean

如果设置为true，则在加载URL时自动开始播放。如果设置为false，则应用必须明确调用播放才能开始播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-autoplay。

继承自

HTMLMediaElement.autoplay

---

buffered

abstract readonly buffered: TimeRanges

获取内容的缓冲时间范围。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-buffered。

继承自

HTMLMediaElement.buffered

---

controls?

optional controls: boolean

启用或禁用媒体控件的用户界面。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-controls。

继承自

HTMLMediaElement.controls

---

currentSrc

abstract readonly currentSrc: string

获取当前正在播放的媒体的源URL。https://html.spec.whatwg.org/multipage/media.html#dom-media-currentsrc（仅提供英文版）。

继承自

HTMLMediaElement.currentSrc

---

currentTime

abstract currentTime: number

获取或设置播放的当前时间。设置当前时间会导致搜索操作。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-currenttime。

继承自

HTMLMediaElement.currentTime

---

defaultSeekIntervalInSec

abstract defaultSeekIntervalInSec: number

为远程控制媒体键按下功能“快进”或“快退”配置默认搜索间隔（以秒为单位）

继承自

HTMLMediaElement.defaultSeekIntervalInSec

---

duration

abstract readonly duration: number

获取正在播放的内容的持续时间。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-duration。

继承自

HTMLMediaElement.duration

---

ended

abstract readonly ended: boolean

检查媒体播放是否已结束。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-ended。

继承自

HTMLMediaElement.ended

---

error

abstract readonly error: MediaError

获取上次遇到的媒体错误。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-error。

继承自

HTMLMediaElement.error

---

height

abstract height: number

设置视频的显示高度。https://html.spec.whatwg.org/multipage/embedded-content-other.html#dom-dim-height（仅提供英文版）。

---

mediaKeys?

abstract readonly optional mediaKeys: MediaKeys

简述

用于解密受DRM保护的内容的媒体密钥。有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-mediakeys。

继承自

HTMLMediaElement.mediaKeys

---

nodeName

abstract readonly nodeName: string

有关更多信息，请参阅https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeName。

继承自

HTMLMediaElement.nodeName

---

paused

abstract readonly paused: boolean

检查媒体播放是否已暂停。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-paused。

继承自

HTMLMediaElement.paused

---

readyState

abstract readonly readyState: number

获取媒体元素的就绪状态。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-readystate。

继承自

HTMLMediaElement.readyState

---

seekable

abstract readonly seekable: TimeRanges

获取内容的可搜索时间范围。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-seekable。

继承自

HTMLMediaElement.seekable

---

seeking

abstract readonly seeking: boolean

检查媒体元素当前是否在搜索。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-seeking。

继承自

HTMLMediaElement.seeking

---

src

abstract src: string

设置媒体源的URL。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#location-of-the-media-resource。

继承自

HTMLMediaElement.src

---

srcObject

abstract srcObject: MediaProvider

设置源MediaProvider对象。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-srcobject。

继承自

HTMLMediaElement.srcObject

---

textTracks

abstract readonly textTracks: TextTrackList

获取文本轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-texttracks。

继承自

HTMLMediaElement.textTracks

---

videoHeight

abstract readonly videoHeight: number

获取视频的高度。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-video-videoheight（仅提供英文版）。

---

videoTracks

abstract readonly videoTracks: VideoTrackList

获取视频轨道的列表。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-videotracks。

继承自

HTMLMediaElement.videoTracks

---

videoWidth

abstract readonly videoWidth: number

获取视频的宽度。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-video-videowidth（仅提供英文版）。

---

width

abstract width: number

设置视频的显示宽度。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/embedded-content-other.html#dom-dim-width（仅提供英文版）。

---

HAVE_CURRENT_DATA

readonly static HAVE_CURRENT_DATA: number = 2

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_current_data。

继承自

HTMLMediaElement.HAVE_CURRENT_DATA

---

HAVE_ENOUGH_DATA

readonly static HAVE_ENOUGH_DATA: number = 4

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_enough_data。

继承自

HTMLMediaElement.HAVE_ENOUGH_DATA

---

HAVE_FUTURE_DATA

readonly static HAVE_FUTURE_DATA: number = 3

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_future_data。

继承自

HTMLMediaElement.HAVE_FUTURE_DATA

---

HAVE_METADATA

readonly static HAVE_METADATA: number = 1

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_metadata。

继承自

HTMLMediaElement.HAVE_METADATA

---

HAVE_NOTHING

readonly static HAVE_NOTHING: number = 0

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-have_nothing。

继承自

HTMLMediaElement.HAVE_NOTHING

方法

addEventListener()

abstract addEventListener(type, listener, options?): void

添加事件侦听器。

参数

type

string

要侦听的事件。

listener

EventListener

事件处理程序函数。

options?

忽略。

boolean

AddEventListenerOptions

返回值

void

继承自

HTMLMediaElement.addEventListener

---

addTextTrack()

abstract addTextTrack(kind, label?, language?, uri?, mimeType?): TextTrack

参数

kind

TextTrackKind

kind参数必须返回TextTrack对象所代表的文本轨道的文本轨道类型。

label?

string

label参数必须返回TextTrack对象所代表的文本轨道的文本轨道标签。

language?

string

language参数必须返回TextTrack对象所代表的文本轨道的文本轨道语言。

uri?

string

uri参数必须返回TextTrack对象所代表的文本轨道的带外字幕的uri。这是自定义添加（不是w3c规范的一部分）。如果您指定uri参数，则该组件将解析并呈现字幕。

mimeType?

string

mimeType参数必须返回TextTrack对象所代表的文本轨道的带外字幕的mime类型。这是自定义添加（不是w3c规范的一部分）。

返回值

TextTrack

简述

有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-addtexttrack。

继承自

HTMLMediaElement.addTextTrack

---

getVideoPlaybackQuality()

abstract getVideoPlaybackQuality(): VideoPlaybackQuality

获取视频播放质量属性。有关更多信息，请参阅https://w3c.github.io/media-playback-quality/#dom-htmlvideoelement-getvideoplaybackquality（仅提供英文版）。

返回值

VideoPlaybackQuality

---

pause()

abstract pause(): void

暂停播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-pause。

返回值

void

继承自

HTMLMediaElement.pause

---

play()

abstract play(): void

开始播放。有关更多信息，请参阅https://html.spec.whatwg.org/multipage/media.html#dom-media-play。

返回值

void

继承自

HTMLMediaElement.play

---

removeEventListener()

abstract removeEventListener(type, listener, options?): void

删除事件侦听器。

参数

type

string

要侦听的事件。

listener

EventListener

要删除的事件处理程序函数。

options?

忽略。

boolean

EventListenerOptions

返回值

void

继承自

HTMLMediaElement.removeEventListener

---

setMediaKeys()

abstract setMediaKeys(mediaKeys?): Promise<void>

参数

mediaKeys?

MediaKeys

有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-mediakeys。

返回值

Promise<void>

简述

设置用于解密受DRM保护的内容的媒体密钥。有关更多信息，请参阅https://www.w3.org/TR/encrypted-media/#dom-htmlmediaelement-setmediakeys。

继承自

HTMLMediaElement.setMediaKeys

---

Last updated: 2025年10月2日