CKTIS / HTML
onpause — controlador del evento de pausa de medios
El atributo onpause contiene JavaScript que gestiona el evento pause, normalmente en un elemento audio o video. Reacciona cuando se pausa la reproducción, pero no la pausa por sí mismo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<audio onpause="handlerCode"></audio>
<video onpause="handlerCode"></video>
media.onpause = handler;
media.addEventListener("pause", handler);onpause es un atributo global de gestión del evento pause. Aunque está disponible en todos los elementos HTML, suele utilizarse para gestionar las pausas de elementos audio y video. Su valor es código JavaScript, no un valor booleano.
Durante una pausa normal de un medio, paused pasa a ser true y el evento se envía en una tarea puesta en cola. Llamar a pause() en un elemento que ya está pausado no genera otro evento pause. El evento no se propaga hacia arriba y no se puede cancelar; return false no impedirá la pausa.
En el código del atributo, event representa el evento y this hace referencia al elemento. La propiedad JavaScript media.onpause acepta una función o null; asignarla de nuevo sustituye la función anterior. media.addEventListener("pause", handler) permite registrar controladores independientes. Una política CSP puede bloquear el código de los atributos.
El ejemplo envía un evento pause sintético para comprobar la conexión del atributo sin un archivo multimedia. El texto esperado es pause. Esta prueba no inicia ni pausa la reproducción y no comprueba una transición real del estado del medio.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>onpause test</title>
<audio id="media" onpause="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('pause'));
</script>Resultado
pause
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.