CKTIS / HTML
onloadstart — tratar o início do carregamento de multimédia
O atributo onloadstart especifica o código JavaScript que trata o evento loadstart. Nos elementos audio e video, este evento assinala o início da procura de dados multimédia, não a conclusão da transferência nem a disponibilidade para reprodução.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onloadstart="JavaScript statements"onloadstart é um atributo de conteúdo de tratamento de eventos para loadstart. O seu valor é o corpo de uma função JavaScript, não o endereço de um recurso. No código do atributo, o parâmetro event disponibiliza o evento. O índice HTML classifica este atributo como disponível nos elementos HTML; ainda assim, a sua presença, por si só, não significa que todos os elementos emitam automaticamente loadstart.
Para audio e video, o navegador dispara loadstart quando começa a procurar dados no algoritmo de seleção de recursos multimédia. Isto não confirma que os dados tenham sido transferidos, que o carregamento tenha sido bem-sucedido ou que a reprodução esteja pronta. loadedmetadata e loadeddata correspondem a fases diferentes; também não se deve confundir loadstart com load.
O atributo HTML onloadstart e a propriedade JavaScript com o mesmo nome configuram o gestor. Em addEventListener('loadstart', handler), o nome do evento não tem o prefixo on. A Content Security Policy pode bloquear código colocado diretamente no atributo.
O exemplo dispara deliberadamente um loadstart sintético, pelo que não precisa de um ficheiro multimédia nem de uma ligação à rede. O parágrafo deverá apresentar loadstart. Isto verifica a chamada do gestor, não o comportamento real do carregamento. Data do instantâneo do índice: 2026-11-18.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>onloadstart</title>
<audio id="media" onloadstart="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('loadstart'));
</script>Resultado
loadstart
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.