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 Ausgangszustand zurück und beginnt den Prozess der Auswahl einer Medienquelle und des Ladens der Medien, um die Wiedergabe von Anfang an zu starten.

Die Menge der 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 indem Sie das src-Attribut des Elements ändern oder indem Sie <source>-Elemente innerhalb des Media-Elements selbst hinzufügen oder entfernen. load() wird das Element zurücksetzen und die verfügbaren Quellen erneut durchsuchen, wodurch die Änderungen wirksam werden.

Syntax

js
load()

Parameter

Keine.

Rückgabewert

Keine (undefined).

Anwendungshinweise

Das Aufrufen von load() bricht alle laufenden Operationen mit diesem Media-Element ab und beginnt dann den Prozess der Auswahl und des Ladens einer geeigneten Medienressource, basierend auf den im <audio>- oder <video>-Element und dessen src-Attribut oder untergeordneten <source>-Elementen angegebenen Optionen. Dies wird detaillierter auf der Seite HTML video und audio beschrieben.

Der Abbruch von laufenden Aktivitäten führt dazu, dass alle noch ausstehenden Promises, die von play() zurückgegeben werden, entsprechend ihrem Status erfüllt oder abgelehnt werden, bevor das Laden neuer Medien beginnen kann. Ausstehende Wiedergabe-Promises werden mit einem "AbortError" DOMException abgebrochen.

Den Mediendateien selbst werden während des Ladeprozesses entsprechende Events gesendet:

  • Wenn das Element bereits dabei ist, Medien zu laden, wird dieser Ladevorgang 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 die Wiedergabeposition tatsächlich ändert (das heißt, sie war nicht bereits am Anfang), wird ein timeupdate-Ereignis gesendet.
  • Sobald Medien ausgewählt sind und das Laden beginnen kann, wird das loadstart-Ereignis ausgelöst.
  • Von diesem Punkt an werden Ereignisse wie bei jedem Medialadevorgang gesendet.

Beispiele

Dieses Beispiel findet ein <video>-Element im Dokument und setzt es durch Aufrufen von load() zurück.

js
const mediaElem = document.querySelector("video");
mediaElem.load();

Spezifikationen

Specification
HTML
# dom-media-load-dev

Browser-Kompatibilität