Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

onsuspend — rukovanje obustavom dohvaćanja medija

Atribut onsuspend određuje JavaScript koji se izvršava pri događaju suspend. Za audio i video taj događaj znači da preglednik trenutačno namjerno ne dohvaća podatke, a ne da je reprodukcija pauzirana.

Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

onsuspend="JavaScript statements"

onsuspend je globalni sadržajni atribut za rukovanje događajem suspend. Njegova je vrijednost JavaScript kod, a ne adresa resursa ili Booleova vrijednost. Iako je atribut dostupan na HTML elementima, obično se upotrebljava na elementima audio i video.

Preglednik pokreće suspend kada namjerno obustavi dohvaćanje medijskih podataka i pritom postavlja networkState na NETWORK_IDLE. Primjerice, može čekati da reprodukcija započne prije preuzimanja dodatnih podataka. To samo po sebi ne znači da je došlo do pogreške ili da je reprodukcija pauzirana: pause se odnosi na reprodukciju, dok se stalled odnosi na slučaj kada preglednik pokušava dohvatiti podatke, ali ih ne prima.

U kodu atributa event daje objekt događaja. U JavaScriptu umjesto toga možete dodijeliti funkciju svojstvu element.onsuspend ili upotrijebiti element.addEventListener('suspend', handler). Naziv događaja ne sadrži prefiks on.

Primjer pokreće sintetički događaj kako rezultat ne bi ovisio o mreži ni odlukama preglednika o međuspremanju. Provjerava samo izvršavanje koda atributa; ne obustavlja dohvaćanje niti mijenja networkState. Sigurnosna pravila stranice mogu blokirati kod za rukovanje događajima zapisan izravno u atributima.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori