CKTIS / JavaScript
Wiedergabestatus und Medienzeit: paused, muted, currentTime und duration
Lies Pausenstatus und Stummschaltung getrennt aus, setze die Wiedergabeposition in Sekunden und unterscheide eine bekannte Dauer von `NaN` und `Infinity`.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
media.paused // boolean, read-only
media.muted // boolean, read/write
media.muted = true // mute the audio output
media.currentTime // number in seconds, read/write
media.currentTime = 12.5 // request a position on the media timeline
media.duration // number in seconds, read-only; may be NaN or Infinitypaused, muted, currentTime und duration sind Instanzeigenschaften von HTMLMediaElement und stehen bei audio- und video-Elementen zur Verfügung. Sie gehören zur Webplattform, nicht zu ECMAScript selbst. Setze sie daher in einer Umgebung ohne DOM nicht voraus.
paused ist ein schreibgeschützter boolescher Wert. Bei einem neuen Element gilt paused === true. Verwende pause() und play(), statt paused einen Wert zuzuweisen. Das von play() zurückgegebene Promise kann abgelehnt werden, etwa wenn der Browser die automatische Wiedergabe blockiert. paused === false allein bedeutet nicht, dass die Wiedergabeposition fortschreitet: Das Element kann auf Daten warten.
muted ist ein les- und schreibbarer boolescher Wert für die aktuelle Stummschaltung. media.muted = true schaltet die Audioausgabe stumm; false hebt die Stummschaltung auf. Stummschalten ist weder Pausieren noch das Setzen von volume auf null. defaultMuted spiegelt das HTML-Attribut muted wider, das die voreingestellte, nicht die aktuelle Stummschaltung angibt.
currentTime liefert die Wiedergabeposition auf der Medienzeitachse in Sekunden, auch mit Nachkommastellen. Vor dem Laden der Metadaten speichert eine Zuweisung die gewünschte Startposition; danach löst sie einen Positionssprung aus. NaN und unendliche Werte verursachen einen TypeError. Die tatsächliche Position kann vom gewünschten Wert abweichen. Prüfe besonders bei Livestreams die Bereiche in seekable und erkenne den Abschluss eines Positionssprungs am Ereignis seeked.
duration ist schreibgeschützt. Ein endlicher Wert gibt den Endzeitpunkt auf der Medienzeitachse in Sekunden an, also die Dauer, wenn die Zeitachse bei null beginnt. NaN bedeutet, dass die Dauer noch nicht verfügbar ist; Infinity steht für Medien ohne bekanntes Ende. Lies den Wert bei loadedmetadata aus und aktualisiere ihn bei durationchange. Berechne auf einer bei null beginnenden Zeitachse currentTime / duration nur, wenn Number.isFinite(duration) && duration > 0 gilt.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Media playback state and time</title>
</head>
<body>
<script>
const media = document.createElement("video");
console.log(`currentTime=${media.currentTime}`);
media.muted = true;
media.currentTime = 2.5;
console.log(
`paused=${media.paused}, muted=${media.muted}, ` +
`currentTime=${media.currentTime}, duration=${media.duration}`
);
</script>
</body>
</html>Ergebnis
currentTime=0 paused=true, muted=true, currentTime=2.5, duration=NaN
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Browserkonsole. Das Element hat keine Medienquelle: `2.5` ist die gespeicherte Startposition und kein Ergebnis eines Positionssprungs oder der Wiedergabe. Das Element bleibt pausiert und `duration` bleibt `NaN`.
Zugehörige Lektionen
- JavaScript · Lektion 28 · Mittlere Stufe · Version: 3