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

CKTIS / HTML

onwaiting – obravnava čakanja na predstavnostne podatke

Atribut onwaiting določa kodo, ki se izvede ob dogodku waiting. Pri elementih audio in video ta dogodek sporoča, da predvajanja ni mogoče nadaljevati, ker ni na voljo dovolj podatkov. Atribut sam ne začne prenosa ali predvajanja.

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

Sintaksa

onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };

onwaiting je atribut za obravnavo dogodka waiting. Njegova vrednost v HTML je koda JavaScript, ne logična vrednost. Na voljo je pri vseh elementih HTML, vendar se običajno uporablja pri elementih audio in video. Njegova ustreznica v JavaScriptu je lastnost onwaiting.

Dogodek waiting pomeni, da predvajanja ni mogoče nadaljevati, ker podatki, potrebni za naslednji korak, niso na voljo. Pojavi se lahko ob začetku predvajanja ali ko zmanjka podatkov v medpomnilniku. Sam po sebi ne pomeni trajne napake ali izgubljene omrežne povezave. Ne zamenjujte ga z dogodkom stalled, ki označuje, da podatki ne prihajajo, medtem ko jih brskalnik poskuša pridobiti.

Obravnavalnik lahko prikaže indikator čakanja; dogodek playing omogoča odziv ob začetku ali nadaljevanju predvajanja. Naravni dogodek waiting se ne širi navzgor in ga ni mogoče preklicati, zato return false ne bo nadaljeval predvajanja. Dodelitev funkcije lastnosti media.onwaiting zamenja prejšnji obravnavalnik te lastnosti; addEventListener('waiting', handler) omogoča registracijo neodvisnih poslušalcev.

Primer namenoma sproži sintetični dogodek, zato rezultat ni odvisen od predstavnostne datoteke ali omrežja. Besedilo odstavka bi se moralo spremeniti iz idle v waiting. Preizkus preverja samo povezavo obravnavalnika: ne povzroči dejanskega medpomnjenja in ne spremeni stanja predvajanja. Varnostni pravilnik strani lahko blokira vstavljene skripte in vstavljene obravnavalnike dogodkov.

Primeri

<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('waiting'));
</script>

Rezultat

waiting

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

Viri