HTMLMediaElement: readyState-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft readyState der Schnittstelle HTMLMediaElement gibt den Bereitschaftszustand des Mediums an.
Wert
Eine Zahl, die einer der fünf möglichen Zustandskonstanten entspricht, die in der Schnittstelle HTMLMediaElement definiert sind:
HTMLMediaElement.HAVE_NOTHING(0)-
Es sind keine Informationen über die Medienressource verfügbar.
HTMLMediaElement.HAVE_METADATA(1)-
Von der Medienressource wurden genügend Daten abgerufen, um die Metadatenattribute zu initialisieren. Das Springen zu einer anderen Wiedergabeposition löst keine Ausnahme mehr aus.
HTMLMediaElement.HAVE_CURRENT_DATA(2)-
Für die aktuelle Wiedergabeposition sind Daten verfügbar, aber nicht genug, um mehr als ein Einzelbild abzuspielen.
HTMLMediaElement.HAVE_FUTURE_DATA(3)-
Für die aktuelle Wiedergabeposition sowie für zumindest einen kurzen Zeitraum danach sind Daten verfügbar (beispielsweise mindestens zwei Videobilder).
HTMLMediaElement.HAVE_ENOUGH_DATA(4)-
Es sind genügend Daten verfügbar – und die Downloadrate ist hoch genug –, um das Medium ohne Unterbrechung bis zum Ende abzuspielen.
Beispiele
Dieses Beispiel wartet darauf, dass Audiodaten für das Element example geladen werden. Anschließend prüft es, ob mindestens die Daten für die aktuelle Wiedergabeposition geladen wurden. Ist dies der Fall, wird das Audio abgespielt.
<audio id="example" preload="auto">
<source src="sound.ogg" type="audio/ogg" />
</audio>
const obj = document.getElementById("example");
obj.addEventListener("loadeddata", () => {
if (obj.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) {
obj.play();
}
});
Spezifikationen
| Spezifikation |
|---|
| HTML> # dom-media-readystate-dev> |
Browser-Kompatibilität
Siehe auch
HTMLMediaElement: Schnittstelle, die die EigenschaftHTMLMediaElement.readyStatedefiniert