HTMLMediaElement:load() 方法
该 HTMLMediaElement
方法 load()
将媒体元素重置为其初始状态,并开始选择媒体源并加载媒体以准备开始播放的过程。
预取的媒体数据量由元素的 preload
属性的值确定。
此方法通常仅在您对媒体元素可用的源集进行了动态更改时才有用,方法是更改元素的 src
属性或添加或删除嵌套在媒体元素本身内的 <source>
元素。load()
将重置元素并重新扫描可用的源,从而使更改生效。
语法
js
load()
参数
无。
返回值
无 (undefined
)。
使用说明
调用 load()
将中止涉及此媒体元素的所有正在进行的操作,然后根据 <audio>
或 <video>
元素及其 src
属性或子 <source>
元素 (s) 中指定的选项,开始选择和加载适当媒体资源的过程。这在 视频和音频内容 页面中有更详细的说明。
中止任何正在进行的活动的过程将导致由 play()
返回的任何未完成的 Promise
根据其在开始加载新媒体之前的状态被相应地 fulfilled 或 rejected。挂起的播放 promise 将使用 "AbortError"
DOMException
中止。
随着加载过程的进行,适当的事件将发送到媒体元素本身
- 如果元素已处于加载媒体的过程中,则该加载过程将中止,并发送
abort
事件。 - 如果元素已使用媒体初始化,则发送
emptied
事件。 - 如果将播放位置重置到媒体的开头实际上改变了播放位置(即它之前不在开头),则会发送
timeupdate
事件。 - 一旦选择了媒体并且加载准备开始,就会传递
loadstart
事件。 - 从这一点开始,事件就像任何媒体加载一样发送。
示例
此示例在文档中找到一个 <video>
元素,并通过调用 load()
重置它。
js
const mediaElem = document.querySelector("video");
mediaElem.load();
规范
规范 |
---|
HTML 标准 # dom-media-load-dev |
浏览器兼容性
BCD 表格仅在浏览器中加载