Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onended: gestionar el final de la reproducción

El atributo onended contiene JavaScript que se ejecuta cuando se recibe un evento ended. En los elementos audio y video, permite reaccionar cuando el contenido multimedia llega al final, no cuando la reproducción simplemente se pausa.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

<audio onended="JavaScript statements"></audio>
<video onended="JavaScript statements"></video>

onended es un atributo de contenido de controlador de eventos para ended. Su valor es el cuerpo de una función JavaScript, no la URL de un archivo ni solo el nombre de una función. Se puede usar event para examinar el evento.

En audio y video, el navegador lanza ended cuando la reproducción hacia delante llega al final del contenido multimedia. Llamar a pause() por sí solo no significa que la reproducción haya terminado. Si se establece loop, al llegar al final durante la reproducción hacia delante, la reproducción vuelve al principio en lugar de lanzar este evento.

Hay que distinguir el atributo HTML onended, la propiedad JavaScript media.onended, que contiene una función controladora, y la propiedad de estado booleana media.ended. Una alternativa al atributo es media.addEventListener('ended', handler); el nombre del evento no lleva el prefijo on.

El ejemplo lanza deliberadamente un evento sintético, por lo que no necesita ningún archivo multimedia. Comprueba la conexión del controlador, no la finalización real de la reproducción. La política de seguridad de una página puede bloquear el código de controlador de eventos integrado en el atributo.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>onended test</title>
<audio id="media" onended="document.getElementById('result').textContent = event.type"></audio>
<output id="result">waiting</output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('ended'));
</script>

Resultado

ended

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.

Fuentes