Baseline Widely available
The HTMLMediaElement
method 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
attribute.
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.
None.
Return valueNone (undefined
).
Calling 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 the HTML video and audio page.
The process of aborting any ongoing activities will cause any outstanding Promise
s returned by play()
being fulfilled 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:
abort
event is sent.emptied
event is sent.timeupdate
event is sent.loadstart
event is delivered.This example finds a <video>
element in the document and resets it by calling load()
.
const mediaElem = document.querySelector("video");
mediaElem.load();
Specifications Browser compatibility
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4