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

CKTIS / HTML

async — executar um script quando estiver pronto

`async` permite obter um script em paralelo com o processamento do documento e executá-lo quando estiver pronto, sem garantir a ordem.

Versão: HTML Living Standard

Sintaxe

<script async src="/feature.js"></script>

É booleano: async="false" continua a ativá-lo. Scripts clássicos externos podem executar antes de terminar a análise; executar o código continua a ocupar a thread principal. Não o uses para scripts dependentes que exijam a ordem do documento.

Nos módulos, diz respeito à disponibilidade do módulo e das suas dependências. Não dá esse comportamento a um script clássico inline. Com defer também presente, prevalece a execução assíncrona. DOMContentLoaded não espera por esses scripts; não é a palavra-chave de funções assíncronas JavaScript.

O exemplo coloca um ficheiro lento antes de um rápido. O recetor local retém propositadamente o primeiro até o segundo executar, obtendo fast → slow. Isso demonstra que a ordem do documento não é imposta, não promete essa ordem numa rede qualquer.

Exemplos

<!doctype html><meta charset="utf-8"><output id="result"></output>
<script>
// Local /slow.js calls record('slow'); /fast.js calls record('fast').
// The test receiver releases slow.js only after fast.js has executed.
window.order = [];
window.record = name => {
  window.order.push(name);
  if (window.order.length === 2) document.querySelector('#result').textContent = window.order.join(' -> ');
};
</script>
<script async src="/slow.js"></script>
<script async src="/fast.js"></script>

Resultado

fast -> slow

O resultado exato provém de respostas locais intencionalmente ordenadas; a obtenção real pode produzir outra ordem.

Fontes