CKTIS / HTML
ontimeupdate — gestionar las actualizaciones del tiempo multimedia
El atributo ontimeupdate contiene JavaScript que gestiona el evento timeupdate, utilizado cuando se actualiza la posición de reproducción de audio o vídeo. Permite actualizar un indicador de tiempo, pero no ofrece una medición precisa del tiempo.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<audio ontimeupdate="JavaScript statements"></audio>
<video ontimeupdate="JavaScript statements"></video>ontimeupdate es un atributo global de controlador de eventos HTML para timeupdate. Su valor es el cuerpo de una función JavaScript, no una URL ni simplemente una declaración de función. Se suele utilizar en elementos audio y video; que esté disponible en otros elementos no significa que estos emitan el evento automáticamente.
Dentro del controlador, this hace referencia al elemento y this.currentTime proporciona la posición de reproducción en segundos. El navegador emite timeupdate durante la reproducción y en otras situaciones en las que cambia la posición, como al buscar una parte del contenido. Su frecuencia no es fija: el evento no es un reloj ni una notificación para cada fotograma.
El atributo HTML ontimeupdate contiene texto fuente, mientras que la propiedad JavaScript element.ontimeupdate acepta una función o null. Otra opción es element.addEventListener('timeupdate', handler). La política de seguridad de contenido (Content Security Policy) puede bloquear el código de los atributos.
El ejemplo activa deliberadamente un evento sintético sin un archivo multimedia. Muestra cómo gestionar el evento y leer el valor inicial de currentTime, no una reproducción ni una búsqueda reales. El texto esperado es 0.0 s.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ontimeupdate demo</title>
<audio id="player" ontimeupdate="document.getElementById('result').textContent = this.currentTime.toFixed(1) + ' s';"></audio>
<output id="result">Waiting</output>
<script>
const player = document.getElementById('player');
player.dispatchEvent(new Event('timeupdate'));
</script>
</html>Resultado
0.0 s
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.