Scripts: normal, async e defer

Como cada forma de carregar JavaScript afeta a leitura do HTML e quando usar cada uma.

5 min de leitura · Iniciante · Revisado em

Por que isso importa

O navegador lê o HTML de cima para baixo e vai montando a página. Quando encontra um <script> comum, ele para de ler o HTML, baixa o arquivo, executa e só então continua. Um script grande no topo da página atrasa tudo o que vem depois.

Os atributos async e defer dizem ao navegador que ele pode baixar o script em paralelo enquanto continua lendo o HTML. A diferença entre eles é quando o script executa.

As três formas, lado a lado

Script comum

<script src="app.js">

A leitura do HTML pausa durante o download e a execução. A página só continua a ser montada depois que o script termina.

async

<script async src="app.js">

O download acontece em paralelo. Assim que termina, o script executa e pausa a leitura só durante a execução. Vários scripts async não respeitam a ordem do documento.

defer

<script defer src="app.js">

O download acontece em paralelo e a execução fica para depois que o HTML inteiro foi lido, antes do evento DOMContentLoaded. Vários scripts defer executam na ordem em que aparecem.

Qual usar

Comparação entre as formas de carregar um script externo
FormaBloqueia a leituraOrdem garantidaQuando usar
<script>Sim, no download e na execuçãoSimRaramente. Só se o código precisar rodar antes do resto da página.
asyncSó durante a execuçãoNãoScripts independentes, como analytics e widgets.
deferNãoSimO código da sua aplicação, que manipula o DOM.
type="module"NãoSimMódulos ES já se comportam como defer por padrão.

Um ponto de partida seguro

<head>
  <script defer src="/app.js"></script>
  <script async src="https://analytics.exemplo.com/a.js"></script>
</head>

Referências

Trilhas relacionadas