CKTIS / HTML
oncanplaythrough — gerir a disponibilidade estimada dos média
O atributo oncanplaythrough contém JavaScript que gere o evento canplaythrough. Em áudio e vídeo, este indica uma possibilidade estimada de reprodução até ao fim sem mais armazenamento em memória intermédia, mas não garante uma reprodução ininterrupta.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough é um atributo de gestão do evento canplaythrough. O seu valor é código JavaScript, não um valor booleano. É normalmente utilizado com elementos audio e video; o código do gestor pode aceder ao objeto event.
O navegador coloca canplaythrough na fila quando readyState passa para HAVE_ENOUGH_DATA (4). Isto significa, em geral, que estima ser possível chegar ao fim da reprodução à playbackRate atual sem mais armazenamento em memória intermédia. Este estado também abrange situações em que esperar mais não permitiria obter mais dados. Não é uma garantia nem uma confirmação de que o ficheiro completo foi transferido. canplay indica um nível de disponibilidade inferior: a possibilidade de iniciar ou retomar a reprodução.
Não confundas o nome do atributo oncanplaythrough com o nome do evento canplaythrough. Em alternativa, podes atribuir uma função à propriedade element.oncanplaythrough ou usar element.addEventListener('canplaythrough', handler). O atributo contém código, enquanto a propriedade recebe uma função.
O exemplo desencadeia deliberadamente um evento sintético, pelo que a verificação não exige um ficheiro multimédia nem uma ligação à rede. O texto esperado no parágrafo é canplaythrough; este teste verifica apenas a ligação do gestor, não a disponibilidade real dos média.
Exemplos
<!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>Resultado
canplaythrough
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.