HTMLMediaElement.load()

您正在阅读此内容的英文版本,因为该语系尚未翻译。 帮助我们翻译此文章吧!

 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 Promises 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 Status Comment
HTML Living Standard
HTMLMediaElement.load()
Living Standard Initial definition.
HTML5
HTMLMediaElement.load()
Recommendation Initial definition.

浏览器兼容性

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
loadChrome Full support 1Edge Full support 12Firefox Full support 3.6IE ? Opera Full support YesSafari Full support 6WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown