CKTIS / HTML
onemptied — gestionar el vaciado de un recurso multimedia
El atributo onemptied especifica el código JavaScript que se ejecuta cuando se produce un evento emptied. En audio y vídeo, este evento se refiere al restablecimiento del estado del recurso multimedia, no a la finalización normal de la reproducción.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onemptied="JavaScript statements"onemptied es un atributo de contenido HTML de gestión de eventos para el evento emptied. Su valor contiene instrucciones JavaScript; dentro del controlador, el objeto del evento está disponible como event. Es un atributo global de gestión de eventos, aunque los elementos audio y video son las fuentes naturales de este evento.
El navegador activa emptied cuando se restablece el estado del recurso multimedia. Por ejemplo, load() pone este evento en cola si el networkState anterior no era NETWORK_EMPTY. Por tanto, llamar a load() en un elemento nuevo y vacío no garantiza que se produzca un evento. No confundas emptied con ended, que indica que la reproducción ha llegado al final, ni con la falta temporal de datos para continuar reproduciéndola.
En JavaScript, en lugar del atributo, puedes asignar una función a media.onemptied o usar media.addEventListener('emptied', handler). El nombre del evento no lleva el prefijo on. Volver a asignar la propiedad sustituye el controlador anterior; addEventListener permite registrar controladores independientes. Una política CSP puede bloquear el código de los atributos de gestión de eventos.
El ejemplo activa deliberadamente un evento emptied sintético, por lo que no necesita un archivo multimedia ni acceso a la red. El resultado visible esperado es emptied. Esto comprueba que el controlador está conectado, no que se haya restablecido realmente el recurso; activar el evento no cambia el estado del medio.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Resultado
emptied
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.