Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

ontimeupdate — tratar atualizações do tempo dos conteúdos multimédia

O atributo ontimeupdate contém JavaScript que trata o evento timeupdate, utilizado quando a posição de reprodução de áudio ou vídeo é atualizada. Permite atualizar um indicador de tempo, mas não fornece uma medição precisa do tempo.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

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

ontimeupdate é um atributo global HTML de tratamento do evento timeupdate. O seu valor é o corpo de uma função JavaScript, não um URL nem apenas uma declaração de função. É normalmente utilizado nos elementos audio e video; estar disponível noutros elementos não significa que estes emitam automaticamente o evento.

Dentro do tratador, this refere-se ao elemento e this.currentTime fornece a posição de reprodução em segundos. O navegador emite timeupdate durante a reprodução e noutras situações em que a posição muda, como ao procurar um ponto do conteúdo. A frequência não é fixa: o evento não é um relógio nem uma notificação para cada fotograma.

O atributo HTML ontimeupdate contém texto-fonte, enquanto a propriedade JavaScript element.ontimeupdate aceita uma função ou null. Uma alternativa é element.addEventListener('timeupdate', handler). A Content Security Policy pode bloquear código nos atributos.

O exemplo emite deliberadamente um evento sintético sem um ficheiro multimédia. Demonstra o tratamento do evento e a leitura do valor inicial de currentTime, não uma reprodução ou procura efetiva. O texto esperado é 0.0 s.

Exemplos

<!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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes