WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onsuspend — Umgang mit ausgesetztem Medienabruf

Das Attribut onsuspend legt JavaScript fest, das beim Ereignis suspend ausgeführt wird. Bei Audio und Video bedeutet dieses Ereignis, dass der Browser derzeit absichtlich keine Daten abruft, nicht, dass die Wiedergabe pausiert wurde.

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

Syntax

onsuspend="JavaScript statements"

onsuspend ist ein globales Event-Handler-Content-Attribut für das Ereignis suspend. Sein Wert ist JavaScript-Code, keine Ressourcenadresse und kein boolescher Wert. Obwohl das Attribut für HTML-Elemente verfügbar ist, wird es üblicherweise bei Elementen audio und video verwendet.

Der Browser löst suspend aus, wenn er den Abruf von Mediendaten absichtlich aussetzt, und setzt dabei networkState auf NETWORK_IDLE. Beispielsweise kann er warten, bis die Wiedergabe beginnt, bevor er weitere Daten herunterlädt. Das bedeutet für sich genommen weder einen Fehler noch eine pausierte Wiedergabe: pause betrifft die Wiedergabe, stalled dagegen den Fall, dass der Browser Daten abzurufen versucht, aber keine erhält.

Im Attributcode stellt event das Ereignisobjekt bereit. In JavaScript können Sie stattdessen der Eigenschaft element.onsuspend eine Funktion zuweisen oder element.addEventListener('suspend', handler) verwenden. Der Ereignisname enthält nicht das Präfix on.

Das Beispiel löst ein synthetisches Ereignis aus, damit das Ergebnis unabhängig von Netzwerk und Entscheidungen des Browsers zur Pufferung ist. Es prüft nur, ob der Attributcode ausgeführt wird; es setzt weder den Abruf aus noch ändert es networkState. Die Sicherheitsrichtlinie einer Seite kann direkt in Attributen geschriebenen Event-Handler-Code blockieren.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>

Ergebnis

suspend

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