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.