CKTIS / HTML
oncanplaythrough — gestire la disponibilità stimata dei media
L’attributo oncanplaythrough contiene JavaScript che gestisce l’evento canplaythrough. Per audio e video, l’evento segnala la possibilità stimata di riprodurre fino alla fine senza ulteriore buffering, ma non garantisce una riproduzione ininterrotta.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough è un attributo di gestione dell’evento canplaythrough. Il suo valore è codice JavaScript, non un valore booleano. Si usa tipicamente con gli elementi audio e video; il codice del gestore può accedere all’oggetto event.
Il browser inserisce canplaythrough nella coda degli eventi quando readyState passa a HAVE_ENOUGH_DATA (4). Di solito ciò significa che stima che la riproduzione, al playbackRate corrente, possa arrivare alla fine senza ulteriore buffering. Questo stato comprende anche i casi in cui attendere più a lungo non permetterebbe di ottenere altri dati. Non garantisce né conferma che l’intero file sia stato scaricato. canplay indica un livello di disponibilità inferiore: la possibilità di avviare o riprendere la riproduzione.
Non confondere il nome dell’attributo oncanplaythrough con quello dell’evento canplaythrough. In alternativa, si può assegnare una funzione alla proprietà element.oncanplaythrough oppure usare element.addEventListener('canplaythrough', handler). L’attributo contiene codice, mentre alla proprietà viene assegnata una funzione.
L’esempio attiva deliberatamente un evento sintetico, quindi per verificarlo non serve né un file multimediale né una connessione di rete. Il testo previsto nel paragrafo è canplaythrough; il test verifica soltanto il collegamento del gestore, non la reale disponibilità dei media.
Esempi
<!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>Risultato
canplaythrough
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.