HTMLMediaElement:load() 方法

基线 广泛可用

此功能已得到良好确立,并且可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用 2015 年 7 月.

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 表格仅在浏览器中加载