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

CKTIS / JavaScript

Carregamento de módulos e divisão do código

Os módulos formam um grafo de dependências. Um import estático declara uma dependência, enquanto `import()` permite que o código peça um módulo durante a execução. A divisão do código em partes carregadas separadamente depende do ambiente e das ferramentas, não apenas da sintaxe JavaScript.

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

// module.mjs
export const name = value;

// main.mjs
import { name } from "./module.mjs";

async function main() {
  const namespace = await import("./module.mjs");
}
main().catch(console.error);

O carregamento de módulos envolve obter um módulo e as suas dependências, ligar os imports aos exports e executar o código. As declarações estáticas import aparecem ao nível superior do módulo; identificam as dependências antes de o corpo do módulo ser executado. Os nomes importados são ligações vivas aos exports, não cópias dos respetivos valores.

O import(specifier) dinâmico é uma expressão também disponível em scripts normais e dentro de condições ou funções. Devolve uma Promise que, se o módulo for carregado, ligado e executado com sucesso, é normalmente cumprida com o objeto de espaço de nomes do módulo, que contém os exports. No entanto, se o módulo exportar um valor invocável com o nome then, o mecanismo de resolução da promessa invoca-o com as funções de resolução e de rejeição. O desfecho da promessa depende então dessa chamada, pelo que não tem necessariamente como valor o objeto de espaço de nomes. Trata a rejeição com try/catch em torno de await ou com .catch(). O argumento pode ser calculado durante a execução.

A divisão do código consiste em preparar partes de uma aplicação que possam ser carregadas separadamente. import() proporciona um ponto de carregamento a pedido, mas o ECMAScript não exige ficheiros de saída separados nem pedidos de rede. A resolução dos especificadores e a obtenção dos módulos dependem do anfitrião; a divisão dos ficheiros de saída depende das ferramentas. Importar novamente o mesmo módulo resolvido não volta a executar o seu código. Se não houver um export invocável com o nome then, ambos os imports dinâmicos, quando bem-sucedidos, fornecem o mesmo objeto de espaço de nomes.

Os módulos estáticos foram introduzidos no ES2015, e import() no ES2020. Isto não é uma tabela de compatibilidade de navegadores: a especificação da linguagem não garante suporte num navegador específico, e o Node 24 não comprova o suporte de Web APIs. No exemplo, main.mjs é o ponto de entrada e ambas as chamadas a import() pedem o mesmo módulo local, math.mjs. Só esse módulo é carregado dinamicamente. O exemplo não demonstra a divisão do código por um bundler.

Exemplos

// math.mjs
export const double = value => value * 2;

// main.mjs
async function main() {
  const first = await import("./math.mjs");
  const second = await import("./math.mjs");
  console.log(first.double(21));
  console.log(first === second);
}
main().catch(console.error);

Resultado

42
true

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