HTMLMediaElement.load()
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.
load()
方法重置媒体成初始化状态,选择一个播放源,为载入媒体重新播放做准备。媒体预播放的信息是由 preload
这个参数决定的。
此方法只在对媒体做动态更改时管用,要么更改src
属性,要么添加或删除source
。 load()
将会重置元素重新扫描可用的源,从而让改动生效。
语法
mediaElement.load();
参数
None.
返回值
undefined
.
使用说明
调用 load()
会使媒体上所有正在进行的操作中止,然后根据 audio
或者 video
元素的 src
或者 source
属性里寻找合适的播放源并重新加载媒体内容。更多查看 Supporting multiple formats 和 Video and audio content 。
The process of aborting any ongoing activities will cause any outstanding Promise
s returned by play()
being resolved or rejected as appropriate based on their status before the loading of new media can begin. Pending play promises are aborted with an "AbortError"
DOMException
.
在 load 过程中 合适的事件会发生并通知给媒体本身,包括:
- 如果已经是
load
过了,则abort
事件发送给媒体。 - If the element has already been initialized with media, the
emptied
event is sent. - 如果重置播放位置到开始,通常指修改播放位置,timeupdate 事件触发。
- 当已经选择了源并且已经准备加载内容了,loadstart 事件触发。
- 之前的几点,媒体加载并且事件已经送达
例子
例子中有一个 <video>
元素然后重置它 load()
.
var mediaElem = document.querySelector("video");
mediaElem.load();
规范
Specification |
---|
HTML Standard # dom-media-load-dev |
浏览器兼容性
BCD tables only load in the browser