CKTIS / HTML
oncanplaythrough — obsługa przewidywanej gotowości mediów
Atrybut oncanplaythrough zawiera kod JavaScript obsługujący zdarzenie canplaythrough. Dla audio i video sygnalizuje ono przewidywaną możliwość odtwarzania do końca bez kolejnego buforowania, a nie gwarancję nieprzerwanego odtwarzania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough to atrybut obsługi zdarzenia canplaythrough. Jego wartością jest kod JavaScript, nie wartość logiczna. Typowe zastosowanie dotyczy elementów audio i video; w kodzie obsługi dostępny jest obiekt event.
Przeglądarka kolejkuje canplaythrough, gdy readyState przechodzi do HAVE_ENOUGH_DATA (4). Zwykle oznacza to przewidywanie, że przy bieżącym playbackRate odtwarzanie dotrze do końca bez dalszego buforowania. Ten stan obejmuje także sytuację, w której dalsze oczekiwanie nie pozwoli uzyskać więcej danych. Nie jest to gwarancja ani potwierdzenie pobrania całego pliku. canplay oznacza słabszy poziom gotowości: możliwość rozpoczęcia lub wznowienia odtwarzania.
Nie myl nazwy atrybutu oncanplaythrough z nazwą zdarzenia canplaythrough. Alternatywami są przypisanie funkcji do właściwości element.oncanplaythrough oraz element.addEventListener('canplaythrough', handler). W atrybucie zapisujesz kod, a do właściwości przypisujesz funkcję.
Przykład celowo wysyła zdarzenie syntetyczne, aby sprawdzenie nie wymagało pliku multimedialnego ani sieci. Oczekiwany tekst akapitu to canplaythrough; taki test sprawdza wyłącznie podłączenie obsługi, a nie rzeczywistą gotowość mediów.
Przykłady
<!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>Wynik
canplaythrough
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.