CKTIS / HTML
onstalled — obravnava zastoja pri prenosu predstavnih datotek
Atribut onstalled določa kodo, ki se izvede ob dogodku stalled, ko brskalnik poskuša pridobiti predstavnostne podatke, vendar ti ne prihajajo. Nanaša se na prenos, ne nujno na prekinitev predvajanja.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);onstalled je vsebinski atribut za obravnavo dogodka stalled. Na voljo je kot globalni atribut HTML, vendar brskalnik ta dogodek običajno pošlje predstavnostnima elementoma audio in video. Njegova vrednost vsebuje stavke JavaScript, ne naslova vira ali logične vrednosti.
Dogodek se zgodi, ko element dejavno poskuša pridobiti predstavnostne podatke, vendar jih v času, ki ga določa mehanizem zaznavanja zastoja, ne prejme. To ne pomeni samodejno napake ali prekinitve predvajanja: podatki v medpomnilniku lahko omogočijo nadaljevanje predvajanja. waiting se nanaša na predvajanje, ki čaka na podatke, medtem ko suspend označuje, da je brskalnik začasno ustavil pridobivanje.
V HTML uporabite onstalled="..."; v JavaScriptu funkcijo priredite lastnosti media.onstalled. Prireditev zamenja prejšnji obravnavalnik na tem mestu. Alternativa media.addEventListener("stalled", handler) registrira neodvisne poslušalce. V kodo atributa ne vstavljajte nezaupanja vrednega besedila; Content Security Policy lahko blokira vstavljene obravnavalnike.
Primer sproži sintetični dogodek, da deterministično preveri povezavo atributa. Ne prenese datoteke in ne simulira dejanskega stanja omrežja ali medpomnilnika. Pričakovano besedilo odstavka je stalled.
Primeri
<!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>Rezultat
stalled
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.