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 Medienelement in seinen Anfangszustand zurück und beginnt mit der Auswahl einer Medienquelle und dem Laden des Mediums, um die Wiedergabe von Anfang an vorzubereiten.

Die Menge der vorab geladenen Mediendaten wird durch den Wert des preload-Attributs des Elements bestimmt.

Diese Methode ist im Allgemeinen nur dann nützlich, wenn Sie dynamische Änderungen an der Menge der für das Medienelement verfügbaren Quellen vorgenommen haben, sei es durch Ändern des src-Attributs des Elements oder durch Hinzufügen oder Entfernen von innerhalb des Medienelements eingebetteten <source>-Elementen. load() setzt das Element zurück und durchsucht die verfügbaren Quellen erneut, wodurch die Änderungen wirksam werden.

Syntax

js
load()

Parameter

Keine.

Rückgabewert

Keine (undefined).

Anwendungshinweise

Das Aufrufen von load() bricht alle laufenden Vorgänge im Zusammenhang mit diesem Medienelement ab und beginnt dann mit der Auswahl und dem Laden einer geeigneten Medienressource basierend auf den im <audio> oder <video>-Element und dessen src-Attribut oder untergeordneten <source>-Element(en) angegebenen Optionen. Dies wird ausführlicher auf der Seite HTML-Video und -Audio verwenden beschrieben.

Das Abbrechen von laufenden Aktivitäten führt dazu, dass alle ausstehenden Promises, die von play() zurückgegeben wurden, je nach Status erfüllt oder abgelehnt werden, bevor das Laden neuer Medien beginnen kann. Ausstehende Wiedergabeversprechen werden mit einem "AbortError" DOMException abgebrochen.

Entsprechende Ereignisse werden an das Medienelement selbst gesendet, während der Ladeprozess fortschreitet:

  • Wenn das Element bereits dabei ist, Medien zu laden, wird dieser Ladeprozess abgebrochen und das abort-Ereignis 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 ändert (d. h., die Position 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 zurück, indem load() aufgerufen wird.

js
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