CKTIS / HTML
onstalled — stockende Mediendownloads behandeln
Das Attribut onstalled legt Code fest, der beim Ereignis stalled ausgeführt wird, wenn der Browser Mediendaten abzurufen versucht, aber keine Daten eintreffen. Es betrifft den Download, nicht unbedingt eine Unterbrechung der Wiedergabe.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled ist ein Event-Handler-Content-Attribut für stalled. Es ist als globales HTML-Attribut verfügbar, aber der Browser löst dieses Ereignis normalerweise für die Medienelemente audio und video aus. Sein Wert enthält JavaScript-Anweisungen, keine Ressourcenadresse und keinen booleschen Wert.
Das Ereignis tritt auf, wenn ein Element aktiv versucht, Mediendaten abzurufen, aber während der vom Mechanismus festgelegten Zeitspanne für stockende Medien keine Daten erhält. Das bedeutet nicht automatisch einen Fehler oder eine unterbrochene Wiedergabe: Gepufferte Daten können die Wiedergabe fortsetzen lassen. waiting betrifft eine Wiedergabe, die auf Daten wartet, während suspend anzeigt, dass der Browser den Abruf ausgesetzt hat.
Verwende in HTML onstalled="..."; weise in JavaScript media.onstalled eine Funktion zu. Die Zuweisung ersetzt den vorherigen Handler in diesem Slot. Die Alternative media.addEventListener("stalled", handler) registriert unabhängige Listener. Füge keinen nicht vertrauenswürdigen Text in Attributcode ein; die Content Security Policy kann Inline-Handler blockieren.
Das Beispiel löst ein synthetisches Ereignis aus, um die Verknüpfung des Attributs deterministisch zu prüfen. Es lädt keine Datei herunter und simuliert weder den tatsächlichen Netzwerk- noch den Pufferzustand. Der erwartete Text im Absatz ist stalled.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('stalled'));
</script>
</html>Ergebnis
stalled
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.