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

js
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 Promises, 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.

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