CKTIS / HTML
oncanplaythrough — gestionar la disponibilidad estimada del medio
El atributo oncanplaythrough contiene JavaScript que gestiona el evento canplaythrough. En audio y vídeo, este indica una posibilidad estimada de reproducir hasta el final sin más almacenamiento en búfer, pero no garantiza una reproducción ininterrumpida.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<audio oncanplaythrough="/* JavaScript */"></audio>
<video oncanplaythrough="/* JavaScript */"></video>oncanplaythrough es un atributo de gestión del evento canplaythrough. Su valor es código JavaScript, no un valor booleano. Se suele usar con elementos audio y video; el código del controlador puede acceder al objeto event.
El navegador pone canplaythrough en la cola cuando readyState cambia a HAVE_ENOUGH_DATA (4). Esto suele significar que estima que la reproducción, con el playbackRate actual, puede llegar hasta el final sin más almacenamiento en búfer. Este estado también abarca situaciones en las que esperar más no permitiría obtener más datos. No garantiza ni confirma que se haya descargado el archivo completo. canplay indica un nivel de disponibilidad menor: la posibilidad de iniciar o reanudar la reproducción.
No confundas el nombre del atributo oncanplaythrough con el nombre del evento canplaythrough. Otras opciones son asignar una función a la propiedad element.oncanplaythrough y usar element.addEventListener('canplaythrough', handler). El atributo contiene código, mientras que la propiedad recibe una función.
El ejemplo activa deliberadamente un evento sintético, de modo que para comprobarlo no hace falta un archivo multimedia ni conexión de red. El texto esperado del párrafo es canplaythrough; esta prueba comprueba únicamente que el controlador esté conectado, no la disponibilidad real del medio.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.