HTMLMediaElement: readyState-Eigenschaft

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 HTMLMediaElement.readyState-Eigenschaft gibt den Bereitschaftszustand des Medienobjekts an.

Wert

Eine Zahl, die eine der fünf möglichen Zustandskonstanten ist, die auf der HTMLMediaElement-Schnittstelle definiert sind:

HTMLMediaElement.HAVE_NOTHING (0)

Es sind keine Informationen über die Medienquelle verfügbar.

HTMLMediaElement.HAVE_METADATA (1)

Genug von der Medienquelle wurde abgerufen, sodass die Metadatenattribute initialisiert sind. Das Suchen wird keine Ausnahme mehr auslösen.

HTMLMediaElement.HAVE_CURRENT_DATA (2)

Daten sind für die aktuelle Wiedergabeposition verfügbar, aber nicht genug, um mehr als einen Frame abzuspielen.

HTMLMediaElement.HAVE_FUTURE_DATA (3)

Daten für die aktuelle Wiedergabeposition sowie für mindestens ein kleines Stück Zeit in die Zukunft sind verfügbar (zum Beispiel mindestens zwei Videoframes).

HTMLMediaElement.HAVE_ENOUGH_DATA (4)

Es sind genügend Daten verfügbar—und die Downloadgeschwindigkeit ist hoch genug—, sodass das Medium ohne Unterbrechung bis zum Ende abgespielt werden kann.

Beispiele

Dieses Beispiel wird auf das Laden von Audiodaten für das Element example warten. Es wird dann überprüfen, ob mindestens die aktuelle Wiedergabeposition geladen wurde. Wenn dies der Fall ist, wird die Audio-Wiedergabe gestartet.

html
<audio id="example" preload="auto">
  <source src="sound.ogg" type="audio/ogg" />
</audio>
js
const obj = document.getElementById("example");

obj.addEventListener("loadeddata", () => {
  if (obj.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) {
    obj.play();
  }
});

Spezifikationen

Specification
HTML
# dom-media-readystate-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
readyState

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch

  • HTMLMediaElement: Schnittstelle zur Definition der HTMLMediaElement.readyState-Eigenschaft