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

CKTIS / HTML

script — incorporar scripts e dados

O elemento script incorpora JavaScript ou referencia um ficheiro externo. O atributo type distingue scripts clássicos, módulos e dados, enquanto async e defer controlam o momento da execução.

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

Sintaxe

<script>/* JavaScript */</script>
<script src="app.js" defer></script>
<script type="module" src="app.js"></script>

O elemento script incorpora código ou obtém-no de src; nesse caso, o código inline não é uma alternativa. É necessária uma etiqueta de fecho. Se type for omitido ou estiver vazio, trata-se de JavaScript clássico; type="module" indica um módulo JavaScript.

Nos scripts clássicos externos inseridos pelo analisador, a ausência de async e defer bloqueia a análise durante a obtenção e a execução. defer permite a obtenção em paralelo e executa os scripts após a análise, pela ordem do documento. async executa quando o script está pronto, sem garantir a ordem; tem prioridade sobre defer.

Os scripts do tipo módulo inseridos pelo analisador sem o atributo async são executados depois de concluída a análise do documento. Os scripts do tipo módulo inseridos dinamicamente podem ser executados assim que estiverem prontos, mesmo sem o atributo async. defer não tem efeito nos scripts do tipo módulo. Para código clássico inline, async e defer não se aplicam. nomodule ignora um script clássico nos navegadores que suportam módulos.

type="importmap" define mapeamentos de importação, enquanto type="speculationrules" define regras de carregamento especulativo. type="application/json" cria um bloco de dados, não JavaScript executável. Estas três formas exigem conteúdo inline sem src. Não coloques conteúdo não fidedigno em scripts executáveis.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Script example</title>
</head>
<body>
  <p id="result">0</p>
  <script>
    document.getElementById("result").textContent = String(2 + 3);
  </script>
</body>
</html>

Resultado

5

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