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.