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

CKTIS / HTML

onprogress — gerir eventos de progresso de transferência

O atributo onprogress contém JavaScript que gere o evento progress. Nos elementos audio e video, diz respeito à transferência de dados multimédia, não ao tempo de reprodução decorrido.

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

Sintaxe

onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);

onprogress é um atributo de gestão do evento progress. Está disponível em todos os elementos HTML, mas a sua mera presença não inicia transferências nem gera eventos. A propriedade JavaScript correspondente também está disponível nos objetos Document e Window.

Em audio e video, progress indica a transferência de dados multimédia. Não significa progresso da reprodução nem fornece automaticamente uma percentagem dos bytes transferidos. O evento multimédia utiliza a interface Event, não ProgressEvent; não pressuponha que loaded e total estão disponíveis.

O valor do atributo é código JavaScript, no qual event se refere ao evento. Em alternativa, atribua uma função a element.onprogress ou utilize element.addEventListener("progress", handler). A atribuição à propriedade substitui o gestor anterior desse mecanismo; addEventListener() permite registar ouvintes independentes.

O exemplo envia explicitamente um evento progress sintético, pelo que o resultado não depende da rede. Testa a gestão do atributo, não o progresso real de uma transferência. A Content Security Policy pode bloquear gestores de eventos e scripts incorporados.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
  document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>

Resultado

progress

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