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

CKTIS / HTML

nomodule — um script clássico para navegadores sem módulos

O atributo booleano `nomodule` de um elemento `script` impede a execução de um script clássico em navegadores que suportam tanto os módulos JavaScript como o próprio atributo. Permite fornecer uma versão antiga do código juntamente com um script de módulo.

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

Sintaxe

<script nomodule src="legacy.js"></script>

nomodule aplica-se a scripts clássicos, tanto incorporados como externos. Um navegador que suporte módulos e nomodule não executa um script clássico marcado com esse atributo. O suporte para módulos, por si só, não basta: o Safari 10.1 suportava scripts de módulo, mas não tinha em conta nomodule, pelo que ambos os scripts podiam ser executados. Um navegador antigo que não reconheça nem módulos nem nomodule ignora o atributo e executa o script clássico, ignorando o script com type="module" por ser de um tipo desconhecido.

É um atributo booleano: a sua presença significa verdadeiro e a sua ausência significa falso. As formas válidas incluem nomodule, nomodule="" e nomodule="nomodule". Escrever nomodule="false" não está em conformidade e o atributo continua presente; para o desativar, remove o atributo.

nomodule não é uma alternativa ativada por um erro do módulo. Se o módulo não for carregado ou gerar um erro, isso não faz com que o script clássico ignorado seja executado. Não combines nomodule com type="module": essa utilização não cumpre os requisitos para autores e não impede a execução do módulo.

O exemplo apresenta duas variantes independentes que definem o texto do mesmo elemento. Com JavaScript ativado e suporte para módulos e nomodule, o resultado esperado é module; num navegador antigo que não suporte nenhum dos dois mecanismos, é classic.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>nomodule demo</title>
<p id="result">pending</p>
<script type="module">
  document.getElementById('result').textContent = 'module';
</script>
<script nomodule>
  document.getElementById('result').textContent = 'classic';
</script>
</html>

Resultado

module

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