Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onsuspend — obravnavanje prekinitve pridobivanja predstavnosti

Atribut onsuspend določa JavaScript, ki se izvede ob dogodku suspend. Pri zvoku in videu ta dogodek pomeni, da brskalnik trenutno namerno ne pridobiva podatkov, ne pa, da je predvajanje začasno ustavljeno.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

onsuspend="JavaScript statements"

onsuspend je globalni vsebinski atribut za obravnavo dogodka suspend. Njegova vrednost je koda JavaScript, ne naslov vira ali logična vrednost. Čeprav je atribut na voljo pri elementih HTML, se običajno uporablja pri elementih audio in video.

Brskalnik sproži suspend, ko namerno začasno ustavi pridobivanje večpredstavnostnih podatkov, pri tem pa nastavi networkState na NETWORK_IDLE. Lahko na primer počaka na začetek predvajanja, preden prenese dodatne podatke. To samo po sebi ne pomeni napake ali začasno ustavljenega predvajanja: pause se nanaša na predvajanje, stalled pa na primer, ko brskalnik poskuša pridobiti podatke, vendar jih ne prejema.

V kodi atributa event zagotavlja objekt dogodka. V JavaScriptu lahko namesto tega funkcijo dodelite lastnosti element.onsuspend ali uporabite element.addEventListener('suspend', handler). Ime dogodka ne vsebuje predpone on.

Primer sproži sintetični dogodek, da rezultat ni odvisen od omrežja ali odločitev brskalnika glede medpomnjenja. Preveri samo izvajanje kode atributa; ne prekine pridobivanja in ne spremeni networkState. Varnostna politika strani lahko blokira kodo za obravnavo dogodkov, zapisano neposredno v atributih.

Primeri

<!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>

Rezultat

suspend

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri