CKTIS / HTML
onsuspend — gerir a suspensão da obtenção de multimédia
O atributo onsuspend especifica o código JavaScript a executar quando ocorre o evento suspend. Em áudio e vídeo, este evento significa que o navegador deixou intencionalmente de obter dados por enquanto, e não que a reprodução foi colocada em pausa.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onsuspend="JavaScript statements"onsuspend é um atributo de conteúdo global para tratar o evento suspend. O seu valor é código JavaScript, não um endereço de recurso nem um valor booleano. Embora o atributo esteja disponível nos elementos HTML, é normalmente utilizado nos elementos audio e video.
O navegador dispara suspend quando suspende intencionalmente a obtenção de dados multimédia, definindo networkState como NETWORK_IDLE. Por exemplo, pode esperar que a reprodução comece antes de descarregar mais dados. Isto, por si só, não significa que exista um erro ou que a reprodução esteja em pausa: pause diz respeito à reprodução, enquanto stalled se refere ao caso em que o navegador tenta obter dados mas não os recebe.
No código do atributo, event disponibiliza o objeto do evento. Em JavaScript, pode, em alternativa, atribuir uma função à propriedade element.onsuspend ou utilizar element.addEventListener('suspend', handler). O nome do evento não inclui o prefixo on.
O exemplo dispara um evento sintético para que o resultado seja independente da rede e das decisões do navegador sobre o armazenamento em memória intermédia. Testa apenas a execução do código do atributo; não suspende a obtenção de dados nem altera networkState. A política de segurança de uma página pode bloquear código de tratamento de eventos escrito diretamente nos atributos.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>Resultado
suspend
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.