CKTIS / HTML
oncanplay: gestionar la disponibilidad de los medios para reproducirlos
El atributo oncanplay contiene JavaScript que se ejecuta cuando se produce el evento canplay. En audio y vídeo, indica que la reproducción puede comenzar o reanudarse, pero no garantiza que todo el recurso pueda reproducirse sin interrupciones por almacenamiento en búfer.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<audio oncanplay="handler(event)"></audio>
<video oncanplay="handler(event)"></video>oncanplay es un atributo de contenido de controlador de eventos para canplay. Su valor es código JavaScript; el controlador tiene acceso al objeto event. El atributo está permitido en todos los elementos HTML, aunque su uso habitual es responder a la disponibilidad de los elementos audio y video.
El navegador dispara canplay cuando el estado de disponibilidad del medio pasa de un nivel inferior a HAVE_FUTURE_DATA o superior. En ese momento hay datos disponibles para continuar la reproducción, pero quizá no los suficientes para reproducir todo el recurso sin almacenamiento en búfer. En cambio, canplaythrough indica que se estima posible reproducir el recurso hasta el final sin detenerse para almacenar datos en búfer. canplay por sí solo no significa que la reproducción ya esté en curso.
En HTML, usa oncanplay="handler(event)"; en JavaScript, asigna una función a media.oncanplay o llama a media.addEventListener('canplay', handler). El nombre del evento no incluye el prefijo on. El ejemplo dispara un evento sintético: comprueba la conexión entre el atributo y su controlador, no la disponibilidad real del medio.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>oncanplay demo</title>
<audio id="media" oncanplay="document.getElementById('result').textContent = event.type"></audio>
<pre id="result">waiting</pre>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('canplay'));
</script>Resultado
canplay
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.