CKTIS / JavaScript
HTMLMediaElement: Zeit, Lautstärke und Wiedergabeereignisse
HTMLMediaElement bietet die gemeinsame API für Audio- und Videoelemente. Lies den Wiedergabestatus aus, ändere Position und Stummschaltung und aktualisiere die Oberfläche anhand von Ereignissen, statt anzunehmen, dass ein Wiedergabebefehl sofort erfolgreich war.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
media.currentTime = seconds; media.volume = 0.5; media.muted = true; media.addEventListener("timeupdate", render);HTMLMediaElement ist die gemeinsame Schnittstelle für Audio- und Videoelemente. Es ist eine durch HTML definierte Web-API und keine Funktion einer bestimmten ECMAScript-Version. Node 24 allein belegt keine Browserunterstützung. Die zentrale Schnittstelle ist weit verbreitet, aber volume hat Kompatibilitätseinschränkungen; prüfe die Zielbrowser und Geräte.
HTMLMediaElement.currentTime gibt die Position in Sekunden an. Hat readyState den Wert HAVE_NOTHING, wie beim Element ohne Quelle im Beispiel, speichert eine Zuweisung die Standardstartposition für die Wiedergabe, statt einen Sprung auszulösen. In den übrigen Zuständen fordert eine Zuweisung einen Sprung innerhalb der verfügbaren Zeitachse an. HTMLMediaElement.duration ist schreibgeschützt: Sekunden, NaN, wenn keine Daten verfügbar sind, oder Infinity bei unbegrenzter Dauer. Berechne den prozentualen Fortschritt nur bei einer endlichen, positiven Dauer. HTMLMediaElement.volume akzeptiert Werte von 0 bis 1. HTMLMediaElement.muted schaltet den Ton unabhängig stumm, ohne die gespeicherte Lautstärke zu ändern.
Die schreibgeschützten Eigenschaften HTMLMediaElement.paused und HTMLMediaElement.ended geben den Pausenzustand beziehungsweise das Ende der Wiedergabe an; sie sind nicht austauschbar. paused === false garantiert keinen Fortschritt, etwa während des Pufferns. HTMLMediaElement.error enthält entweder null oder ein MediaError-Objekt. Die Ereignisse play und pause melden Zustandsänderungen, während die Methoden play() und pause() Befehle auslösen. Behandle eine Ablehnung des von play() zurückgegebenen Promise, etwa wenn die Autoplay-Richtlinie die Wiedergabe blockiert.
loadedmetadata signalisiert geladene Metadaten, durationchange eine Änderung der Dauer und emptied einen geleerten Ressourcenstatus – aktualisiere dann ebenfalls die Oberfläche. Verwende timeupdate, um die Position zu aktualisieren, aber nicht als Taktgeber für Frames: Die Häufigkeit hängt von der Auslastung ab. volumechange betrifft Änderungen an volume oder muted; ended signalisiert das Ende der Wiedergabe. Das Ereignis error kann nicht nur einen Fehler beim Laden der Ressource melden, sondern auch einen schwerwiegenden Dekodierungsfehler nach Beginn der Wiedergabe. Lies die aktuellen Eigenschaften in den Ereignisbehandlern aus.
Das Beispiel erstellt ein Element ohne Quelle, registriert Ereignisse und gibt den Anfangszustand aus. Es spielt weder eine Datei ab noch testet es die Dekodierung. NaN wird absichtlich als Text dargestellt, damit die JSON-Serialisierung diesen Unterschied beibehält.
Beispiele
const media = document.createElement("audio");
const events = [
"timeupdate", "loadedmetadata", "durationchange", "emptied",
"play", "pause", "volumechange", "ended", "error"
];
function snapshot() {
return JSON.stringify({
currentTime: media.currentTime,
duration: Number.isNaN(media.duration) ? "NaN" : String(media.duration),
volume: media.volume,
muted: media.muted,
paused: media.paused,
ended: media.ended,
error: media.error === null ? null : media.error.code
});
}
for (const type of events) {
media.addEventListener(type, () => console.log(type, snapshot()));
}
console.log(snapshot());Ergebnis
{"currentTime":0,"duration":"NaN","volume":1,"muted":false,"paused":true,"ended":false,"error":null}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.
Quellen
- HTMLMediaElement - Web APIs | MDN
- HTMLMediaElement: currentTime property - Web APIs | MDN
- HTMLMediaElement: duration property - Web APIs | MDN
- HTMLMediaElement: volume property - Web APIs | MDN
- HTMLMediaElement: timeupdate event - Web APIs | MDN
- HTMLMediaElement: volumechange event - Web APIs | MDN
- HTMLMediaElement: paused property - Web APIs | MDN
- HTMLMediaElement: ended property - Web APIs | MDN
- HTMLMediaElement: error property - Web APIs | MDN
- HTMLMediaElement: play() method - Web APIs | MDN