WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

ondurationchange — Änderungen der Mediendauer behandeln

Das Attribut ondurationchange enthält JavaScript, das beim Ereignis durationchange ausgeführt wird. Es dient meist dazu, Angaben zur Dauer in audio- und video-Elementen zu aktualisieren; es meldet nicht den laufenden Wiedergabefortschritt.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

ondurationchange="JavaScript statements"

ondurationchange ist ein Event-Handler-Content-Attribut für durationchange, das typischerweise mit audio- und video-Elementen verwendet wird. Sein Wert ist JavaScript-Code, kein Boolean und kein Dauerwert. Im Attribut-Handler verweist this auf das Element und event stellt das Ereignisobjekt bereit.

Der Browser löst dieses Ereignis aus, wenn sich die ermittelte Dauer der Ressource ändert, etwa wenn sie bekannt wird oder korrigiert wird. Lies this.duration aus: Das Ergebnis wird in Sekunden angegeben, NaN bedeutet, dass keine Daten verfügbar sind, und Infinity steht für eine unbegrenzte Dauer. Dies ist kein Ereignis für den Wiedergabefortschritt; verwende dafür timeupdate.

In JavaScript kannst du stattdessen einer Funktion media.ondurationchange zuweisen oder media.addEventListener('durationchange', handler) verwenden. Der Ereignisname hat kein on-Präfix. Eine Zuweisung an die Eigenschaft ersetzt den vorhandenen Handler in diesem Slot; mit addEventListener lassen sich unabhängige Listener hinzufügen. Eine CSP-Richtlinie kann Code blockieren, der direkt im Attribut steht.

Das Beispiel löst ein synthetisches Ereignis aus, ohne Medien abzurufen. Es prüft die Verbindung zwischen Attribut und Handler, nicht das Erkennen einer tatsächlichen Änderung der Dauer. Da duration nicht geändert wird, lautet der erwartete Text durationchange: NaN.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('durationchange'));
</script>

Ergebnis

durationchange: NaN

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