CKTIS / HTML
onstalled — zpracování uváznutého stahování médií
Atribut onstalled určuje kód, který se spustí při události stalled, když se prohlížeč pokouší získat mediální data, ale žádná nepřicházejí. Týká se stahování, nikoli nutně přerušení přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled je obsahový atribut obsluhy události stalled. Je dostupný jako globální atribut HTML, ale prohlížeč tuto událost přirozeně odesílá multimediálním prvkům audio a video. Jeho hodnota obsahuje příkazy JavaScriptu, nikoli adresu zdroje nebo logickou hodnotu.
Událost nastane, když se prvek aktivně pokouší získat mediální data, ale po dobu stanovenou mechanismem detekce uváznutí žádná neobdrží. Neznamená to automaticky chybu ani přerušení přehrávání: data ve vyrovnávací paměti mohou umožnit pokračování přehrávání. waiting se týká přehrávání čekajícího na data, zatímco suspend označuje, že prohlížeč pozastavil načítání.
V HTML použijte onstalled="..."; v JavaScriptu přiřaďte funkci k media.onstalled. Přiřazení nahradí předchozí obsluhu v daném slotu. Alternativa media.addEventListener("stalled", handler) registruje nezávislé posluchače. Do kódu atributu nevkládejte nedůvěryhodný text; Content Security Policy může blokovat obsluhy inline.
Příklad vyvolá syntetickou událost, aby deterministicky ověřil propojení atributu. Nestahuje žádný soubor a nesimuluje skutečný stav sítě ani vyrovnávací paměti. Očekávaný text odstavce je stalled.
Příklady
<!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>Výsledek
stalled
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.