HTMLMediaElement: load() Methode
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.
Die Methode load()
des HTMLMediaElement
setzt das Media-Element in seinen Anfangszustand zurück und beginnt den Prozess der Auswahl einer Medienquelle und des Ladens der Medien, um die Wiedergabe von Anfang an vorzubereiten.
Die Menge an vorab geladenen Mediendaten wird durch den Wert des preload
-Attributs des Elements bestimmt.
Diese Methode ist im Allgemeinen nur nützlich, wenn Sie dynamische Änderungen an der Menge der für das Media-Element verfügbaren Quellen vorgenommen haben, entweder durch Ändern des src
-Attributs des Elements oder durch Hinzufügen oder Entfernen von verschachtelten <source>
-Elementen innerhalb des Media-Elements selbst. load()
wird das Element zurücksetzen und die verfügbaren Quellen erneut scannen und so die Änderungen wirksam werden lassen.
Syntax
load()
Parameter
Keine.
Rückgabewert
Keiner (undefined
).
Verwendungshinweise
Der Aufruf von load()
bricht alle laufenden Operationen, die dieses Media-Element betreffen, ab und beginnt dann den Prozess der Auswahl und des Ladens einer geeigneten Medienressource unter Berücksichtigung der im <audio>
oder <video>
Element und seinem src
-Attribut oder untergeordneten <source>
-Element(en) angegebenen Optionen. Dies wird ausführlicher auf der Seite Video und Audio-Inhalte beschrieben.
Der Prozess des Abbruchs von laufenden Aktivitäten führt dazu, dass alle ausstehenden Promise
s, die von play()
zurückgegeben wurden, erfüllt oder abgelehnt werden, je nach ihrem Status, bevor das Laden der neuen Medien beginnen kann. Ausstehende Wiedergabeversprechen werden mit einem "AbortError"
DOMException
abgebrochen.
Entsprechende Ereignisse werden an das Media-Element selbst gesendet, während der Ladeprozess fortschreitet:
- Wenn das Element bereits im Prozess des Ladens von Medien ist, wird dieser Ladeprozess abgebrochen und das
abort
-Ereignis wird gesendet. - Wenn das Element bereits mit Medien initialisiert wurde, wird das
emptied
-Ereignis gesendet. - Wenn das Zurücksetzen der Wiedergabeposition auf den Anfang des Mediums tatsächlich die Wiedergabeposition verändert (d. h. es war nicht bereits am Anfang), wird ein
timeupdate
-Ereignis gesendet. - Sobald Medien ausgewählt wurden und das Laden bereit ist zu beginnen, wird das
loadstart
-Ereignis ausgeliefert. - Von diesem Punkt an werden Ereignisse wie bei jedem Medienladen gesendet.
Beispiele
Dieses Beispiel findet ein <video>
-Element im Dokument und setzt es durch den Aufruf von load()
zurück.
const mediaElem = document.querySelector("video");
mediaElem.load();
Spezifikationen
Specification |
---|
HTML Standard # dom-media-load-dev |
Browser-Kompatibilität
BCD tables only load in the browser