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

CKTIS / HTML

ondurationchange — gestionar cambios en la duración de los medios

El atributo ondurationchange contiene JavaScript que se ejecuta cuando se produce el evento durationchange. Suele utilizarse para actualizar la información de duración de los elementos audio y video; no indica el progreso de la reproducción en curso.

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

Sintaxis

ondurationchange="JavaScript statements"

ondurationchange es un atributo de controlador de eventos para durationchange, que suele utilizarse con elementos audio y video. Su valor es código JavaScript, no un booleano ni un valor de duración. Dentro del controlador definido en el atributo, this hace referencia al elemento y event proporciona el objeto del evento.

El navegador dispara este evento cuando cambia la duración establecida del recurso, por ejemplo, cuando se conoce o se revisa. Lee this.duration: el resultado se expresa en segundos, NaN significa que no hay datos disponibles e Infinity indica una duración ilimitada. No es un evento de progreso de reproducción; para eso, usa timeupdate.

En JavaScript, puedes asignar una función a media.ondurationchange o usar media.addEventListener('durationchange', handler). El nombre del evento no lleva el prefijo on. Asignar la propiedad sustituye al controlador existente en ese espacio; addEventListener permite añadir controladores independientes. Una política CSP puede bloquear el código escrito directamente en el atributo.

El ejemplo dispara un evento sintético sin descargar contenido multimedia. Comprueba la conexión entre el atributo y el controlador, no la detección de un cambio real de duración. No modifica duration, por lo que el texto esperado es durationchange: NaN.

Ejemplos

<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('durationchange'));
</script>

Resultado

durationchange: NaN

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