CKTIS / HTML
oncanplaythrough — zpracování odhadované připravenosti médií
Atribut oncanplaythrough obsahuje JavaScript, který zpracovává událost canplaythrough. U audia a videa tato událost signalizuje odhadovanou možnost přehrát obsah až do konce bez dalšího načítání do vyrovnávací paměti, nezaručuje však nepřerušované přehrávání.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough je atribut obsluhy události canplaythrough. Jeho hodnotou je kód JavaScriptu, nikoli booleovská hodnota. Typicky se používá u prvků audio a video; kód obsluhy má přístup k objektu event.
Prohlížeč zařadí událost canplaythrough do fronty, když se readyState změní na HAVE_ENOUGH_DATA (4). Obvykle to znamená, že podle odhadu může přehrávání při aktuální hodnotě playbackRate dosáhnout konce bez dalšího načítání do vyrovnávací paměti. Tento stav zahrnuje i situace, kdy delší čekání nemůže přinést další data. Nejde o záruku ani potvrzení, že byl stažen celý soubor. canplay označuje nižší úroveň připravenosti: možnost přehrávání spustit nebo obnovit.
Nezaměňujte název atributu oncanplaythrough s názvem události canplaythrough. Alternativou je přiřadit funkci vlastnosti element.oncanplaythrough nebo použít element.addEventListener('canplaythrough', handler). Atribut obsahuje kód, zatímco vlastnosti se přiřazuje funkce.
Příklad záměrně vyvolává syntetickou událost, takže ověření nevyžaduje mediální soubor ani připojení k síti. Očekávaný text odstavce je canplaythrough; tento test ověřuje pouze napojení obsluhy, nikoli skutečnou připravenost médií.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>oncanplaythrough test</title>
<audio id="media" oncanplaythrough="document.getElementById('status').textContent = event.type"></audio>
<p id="status">Pending</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplaythrough'));
</script>Výsledek
canplaythrough
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.