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

CKTIS / HTML

onwaiting — gerir a espera por dados multimédia

O atributo onwaiting especifica o código a executar para o evento waiting. Nos elementos audio e video, este evento indica que a reprodução não pode continuar por não haver dados suficientes disponíveis. O atributo, por si só, não inicia a transferência nem a reprodução.

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

Sintaxe

onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };

onwaiting é o atributo de tratamento do evento waiting. O seu valor HTML é código JavaScript, não um valor booleano. Está disponível em todos os elementos HTML, mas é normalmente usado com elementos audio e video. A propriedade JavaScript correspondente é onwaiting.

O evento waiting indica que a reprodução não pode continuar porque os dados necessários para o passo seguinte não estão disponíveis. Pode ocorrer ao iniciar a reprodução ou quando o buffer se esgota. Por si só, não significa que exista um erro permanente nem que a ligação à rede tenha sido perdida. Não o confunda com stalled, que diz respeito à ausência de dados enquanto o navegador tenta obtê-los.

Um handler pode apresentar um indicador de espera; o evento playing permite reagir quando a reprodução começa ou é retomada. Um evento waiting natural não propaga e não pode ser cancelado, pelo que return false não retoma a reprodução. Atribuir uma função a media.onwaiting substitui o handler anterior dessa propriedade; addEventListener('waiting', handler) permite registar listeners independentes.

O exemplo envia deliberadamente um evento sintético para que o resultado não dependa de um ficheiro multimédia nem da rede. O parágrafo deverá mudar de idle para waiting. Este teste verifica apenas a ligação do handler: não provoca buffering real nem altera o estado da reprodução. A política de segurança de uma página pode bloquear scripts e handlers de eventos inline.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('waiting'));
</script>

Resultado

waiting

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