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

CKTIS / HTML

ondurationchange — lidar com alterações na duração dos conteúdos multimédia

O atributo ondurationchange contém JavaScript executado quando ocorre o evento durationchange. É normalmente utilizado para atualizar informações sobre a duração em elementos audio e video; não indica o progresso da reprodução em curso.

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

Sintaxe

ondurationchange="JavaScript statements"

ondurationchange é um atributo de gestão do evento durationchange, normalmente utilizado com elementos audio e video. O seu valor é código JavaScript, não um valor booleano nem uma duração. No gestor definido no atributo, this refere-se ao elemento e event disponibiliza o objeto do evento.

O navegador dispara este evento quando a duração determinada do recurso se altera, por exemplo, quando passa a ser conhecida ou é revista. Consulta this.duration: o resultado é expresso em segundos, NaN significa que não existem dados disponíveis e Infinity indica uma duração ilimitada. Não é um evento de progresso da reprodução; para esse efeito, utiliza timeupdate.

Em JavaScript, podes atribuir uma função a media.ondurationchange ou utilizar media.addEventListener('durationchange', handler). O nome do evento não tem o prefixo on. A atribuição à propriedade substitui o gestor existente nesse espaço; addEventListener permite adicionar gestores independentes. Uma política CSP pode bloquear código escrito diretamente no atributo.

O exemplo dispara um evento sintético sem obter conteúdos multimédia. Verifica a ligação entre o atributo e o gestor, não a deteção de uma alteração real da duração. Não altera duration, pelo que o texto esperado é durationchange: NaN.

Exemplos

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

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