Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onsuspend — práce s pozastavením načítání médií

Atribut onsuspend určuje JavaScript, který se spustí při události suspend. U zvuku a videa tato událost znamená, že prohlížeč právě záměrně nenačítá data, nikoli že bylo pozastaveno přehrávání.

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

Syntaxe

onsuspend="JavaScript statements"

onsuspend je globální obsahový atribut obsluhy události suspend. Jeho hodnotou je kód JavaScriptu, nikoli adresa zdroje nebo logická hodnota. Atribut je dostupný u prvků HTML, obvykle se však používá u prvků audio a video.

Prohlížeč vyvolá suspend, když záměrně pozastaví načítání mediálních dat, a nastaví přitom networkState na NETWORK_IDLE. Může například čekat na začátek přehrávání, než stáhne další data. Samo o sobě to neznamená chybu ani pozastavené přehrávání: pause se týká přehrávání, zatímco stalled označuje situaci, kdy se prohlížeč pokouší načítat data, ale žádná nepřijímá.

V kódu atributu zpřístupňuje event objekt události. V JavaScriptu můžete místo toho přiřadit funkci vlastnosti element.onsuspend nebo použít element.addEventListener('suspend', handler). Název události neobsahuje předponu on.

Příklad vyvolá syntetickou událost, aby výsledek nezávisel na síti ani na rozhodnutích prohlížeče o ukládání do vyrovnávací paměti. Ověřuje pouze spuštění kódu atributu; nepozastavuje načítání ani nemění networkState. Bezpečnostní zásady stránky mohou blokovat kód obsluhy události zapsaný přímo v atributech.

Příklady

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

Výsledek

suspend

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje