CKTIS / HTML
onemptied — tratar o esvaziamento de um recurso multimédia
O atributo onemptied especifica o código JavaScript a executar quando ocorre um evento emptied. No caso de áudio e vídeo, este evento diz respeito à reposição do estado do recurso multimédia, e não ao fim normal da reprodução.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onemptied="JavaScript statements"onemptied é um atributo de conteúdo HTML de tratamento do evento emptied. O seu valor contém instruções JavaScript; dentro do processador, o objeto do evento está disponível como event. É um atributo global de tratamento de eventos, mas os elementos audio e video são as fontes naturais deste evento.
O navegador dispara emptied quando o estado do recurso multimédia é reposto. Por exemplo, load() coloca este evento na fila se o networkState anterior não fosse NETWORK_EMPTY. Assim, chamar load() num elemento novo e vazio não garante que ocorra um evento. Não confundas emptied com ended, que indica que a reprodução chegou ao fim, nem com a falta temporária de dados para continuar a reprodução.
Em JavaScript, em vez do atributo, podes atribuir uma função a media.onemptied ou utilizar media.addEventListener('emptied', handler). O nome do evento não tem o prefixo on. Uma nova atribuição à propriedade substitui o processador anterior; addEventListener permite registar processadores independentes. Uma política CSP pode bloquear código nos atributos de tratamento de eventos.
O exemplo dispara deliberadamente um evento emptied sintético, pelo que não precisa de um ficheiro multimédia nem de acesso à rede. O resultado visível esperado é emptied. Isto testa a ligação do processador, não uma reposição real do recurso; disparar o evento não altera o estado do media.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Resultado
emptied
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.