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

CKTIS / HTML

onstalled — lidar com transferências multimédia bloqueadas

O atributo onstalled especifica o código a executar para o evento stalled, quando o navegador tenta obter dados multimédia mas estes não chegam. Isto diz respeito à transferência, não necessariamente a uma interrupção da reprodução.

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

Sintaxe

HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);

onstalled é um atributo de conteúdo de tratamento de eventos para stalled. Está disponível como atributo HTML global, mas o navegador envia normalmente este evento para os elementos multimédia audio e video. O seu valor contém instruções JavaScript, não um endereço de recurso nem um valor booleano.

O evento ocorre quando um elemento está a tentar obter dados multimédia, mas não recebe nenhuns durante o tempo limite definido pelo mecanismo de deteção de bloqueio. Isto não significa automaticamente que exista um erro ou que a reprodução tenha sido interrompida: os dados em buffer podem permitir que a reprodução continue. waiting diz respeito à reprodução à espera de dados, enquanto suspend indica que o navegador suspendeu a obtenção.

Em HTML, utiliza onstalled="..."; em JavaScript, atribui uma função a media.onstalled. A atribuição substitui o tratamento anterior nesse espaço. A alternativa media.addEventListener("stalled", handler) regista ouvintes independentes. Não insiras texto não fidedigno no código do atributo; a Content Security Policy pode bloquear tratamentos inline.

O exemplo envia um evento sintético para verificar de forma determinística a ligação do atributo. Não transfere qualquer ficheiro nem simula o estado real da rede ou do buffer. O texto esperado no parágrafo é stalled.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('stalled'));
</script>
</html>

Resultado

stalled

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