HTMLMediaElement.load()

在此页

句法
用法注意事项
范例
规范
浏览器兼容性
相关话题

HTMLMediaElement 方法 load() resets the media element to its initial state and begins the process of selecting a media source and loading the media in preparation for playback to begin at the beginning. The amount of media data that is prefetched is determined by the value of the element's preload 属性。

This method is generally only useful when you've made dynamic changes to the set of sources available for the media element, either by changing the element's src attribute or by adding or removing <source> elements nested within the media element itself. load() will reset the element and rescan the available sources, thereby causing the changes to take effect.

句法

mediaElement.load();

参数

None.

返回值

undefined .

用法注意事项

调用 load() aborts all ongoing operations involving this media element, then begins the process of selecting and loading an appropriate media resource given the options specified in the <audio> or <video> element and its src attribute or child <source> element(s). This is described in more detail in Supporting multiple formats in 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 .

Appropriate events will be sent to the media element itself as the load process proceeds:

If the element is already in the process of loading media, that load process is aborted and the abort event is sent.
If the element has already been initialized with media, the emptied event is sent.
If resetting the playback position to the beginning of the media actually changes the playback position (that is, it was not already at the beginning), a timeupdate event is sent.
Once media has been selected and loading is ready to begin, the loadstart event is delivered.
From this point onward, events are sent just like any media load.

范例

This example finds a <video> element in the document and resets it by calling load() .

var mediaElem = document.querySelector("video");
mediaElem.load();

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLMediaElement.load()' in that specification.	实时标准	初始定义。
HTML5 The definition of 'HTMLMediaElement.load()' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`load`	Chrome 1	Edge 12	Firefox 3.6	IE ?	Opera Yes	Safari 6	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android Yes	Safari iOS Yes	Samsung Internet Android 1.0

图例

完整支持
兼容性未知 ?

元数据

最后修改： Mar 18, 2019

在此页

句法

参数

返回值

用法注意事项

范例

规范

浏览器兼容性

图例

相关话题