WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onwaiting – Warten auf Mediendaten behandeln

Das Attribut onwaiting legt fest, welcher Code beim Ereignis waiting ausgeführt wird. Bei Audio- und Videoelementen signalisiert dieses Ereignis, dass die Wiedergabe mangels ausreichender Daten nicht fortgesetzt werden kann. Das Attribut selbst startet weder einen Download noch die Wiedergabe.

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

Syntax

onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };

onwaiting ist das Ereignisbehandlungsattribut für waiting. Sein HTML-Wert ist JavaScript-Code und kein boolescher Wert. Es ist für alle HTML-Elemente verfügbar, wird aber typischerweise mit audio- und video-Elementen verwendet. Das JavaScript-Gegenstück ist die Eigenschaft onwaiting.

Das Ereignis waiting zeigt an, dass die Wiedergabe nicht fortgesetzt werden kann, weil die für den nächsten Schritt benötigten Daten nicht verfügbar sind. Es kann beim Starten der Wiedergabe oder nach dem Aufbrauchen des Puffers auftreten. Für sich allein bedeutet es weder einen dauerhaften Fehler noch eine verlorene Netzwerkverbindung. Verwechsle es nicht mit stalled, das sich darauf bezieht, dass keine Daten eintreffen, während der Browser versucht, sie abzurufen.

Ein Handler kann eine Warteanzeige einblenden; mit dem Ereignis playing kannst du reagieren, wenn die Wiedergabe beginnt oder fortgesetzt wird. Ein natürlich ausgelöstes Ereignis waiting bubbelt nicht und ist nicht abbrechbar, daher setzt return false die Wiedergabe nicht fort. Die Zuweisung einer Funktion an media.onwaiting ersetzt den bisherigen Handler dieser Eigenschaft; mit addEventListener('waiting', handler) lassen sich unabhängige Listener registrieren.

Das Beispiel löst absichtlich ein synthetisches Ereignis aus, damit das Ergebnis nicht von einer Mediendatei oder dem Netzwerk abhängt. Der Absatz sollte sich von idle zu waiting ändern. Damit wird nur geprüft, ob der Handler korrekt angeschlossen ist: Es kommt zu keinem tatsächlichen Puffern und der Wiedergabestatus ändert sich nicht. Die Sicherheitsrichtlinie einer Seite kann Inline-Skripte und Inline-Ereignishandler blockieren.

Beispiele

<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('waiting'));
</script>

Ergebnis

waiting

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