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

CKTIS / JavaScript

Scripts de módulo: script type=module

O atributo `type="module"` identifica o script como um script de módulo. O código escrito diretamente no elemento é tratado como um módulo JavaScript. A norma HTML também permite indicar um módulo de entrada WebAssembly através de `src`, mas o suporte varia consoante o navegador. Os módulos JavaScript suportam `import` e `export`, são executados automaticamente em modo estrito e têm um âmbito próprio para as declarações.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

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

O símbolo script type=module designa um elemento script com o atributo type="module". O código pode ser colocado dentro do elemento ou pode ser indicado um ficheiro através de src. Esta é a integração dos módulos JavaScript em HTML, não uma edição distinta de ECMAScript.

Os módulos suportam import e export e são executados em modo estrito. As declarações de nível superior, incluindo var, não criam propriedades em window. No exemplo, moduleValue permanece no âmbito do módulo.

Um módulo escrito na marcação do documento, sem async, é executado depois de terminar a análise do HTML e de as dependências estarem prontas. Assim, o exemplo pode aceder ao elemento posterior result. O atributo defer não tem efeito nos módulos; async permite executar um módulo pronto sem esperar pelo fim da análise.

O tipo MIME exigido depende do tipo de módulo pedido. Um módulo de entrada JavaScript carregado através de src requer um tipo MIME de JavaScript. A norma HTML também permite indicar através de src um módulo de entrada WebAssembly servido com o tipo application/wasm, mas o suporte para este caso varia consoante o navegador. Uma dependência JSON importada com with { type: "json" } requer um tipo MIME de JSON. A obtenção a partir de outra origem requer autorização CORS. Verifique o suporte nos navegadores de destino; a presença de Node 24 no repositório não comprova o suporte dos navegadores.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Module script</title>
  <script type="module">
    var moduleValue = 42;
    document.getElementById("result").textContent =
      `${moduleValue}; ${Object.hasOwn(window, "moduleValue")}`;
  </script>
</head>
<body>
  <output id="result"></output>
</body>
</html>

Resultado

42; false

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