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

CKTIS / JavaScript

Módulos e limites de responsabilidade

Os módulos ECMAScript separam declarações internas de exportações explícitas. Os imports ligam módulos, enquanto um módulo barrel reúne reexportações num único ponto de entrada.

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

// Separate forms, not a single module.

// Export an existing local binding named `name`.
export { name };

// Import a named export as a local binding.
import { name } from "./module.mjs";

// Re-export a named export directly from another module.
export { name } from "./module.mjs";

Um módulo ECMAScript tem o seu próprio âmbito e é executado em modo estrito. export define a interface disponível para outros módulos, enquanto import disponibiliza exportações selecionadas. Um limite de módulo ajuda a ocultar detalhes de implementação, mas não é um limite de isolamento de segurança. A sintaxe de módulos data do ECMAScript 2015; o carregamento e a resolução de especificadores dependem do ambiente anfitrião.

As ligações importadas são vivas: a sua leitura reflete as alterações feitas no módulo que as exporta. Um módulo importador não pode atribuir um novo valor a uma ligação deste tipo; isto não torna imutável um objeto importado. As declarações estáticas import e export surgem no nível superior do módulo.

Módulo barrel é uma designação convencional para um módulo que reúne reexportações, não uma construção separada da linguagem. No exemplo, index.mjs expõe increment e read, enquanto count permanece interno. As reexportações explícitas documentam a interface pública. export * não reencaminha a exportação default, e colisões de nomes podem tornar um import ambíguo.

Guarda as três secções do exemplo como ficheiros separados numa só pasta; não as juntes num único script. Executa main.mjs num ambiente de consola compatível com módulos ECMAScript. O resultado esperado é 0, seguido de 1 em linhas distintas. O exemplo foi executado em Node.js e a saída correspondeu exatamente à esperada. Isto não comprova que as APIs do navegador sejam suportadas.

Exemplos

// counter.mjs
let count = 0;
export function increment() {
  count += 1;
}
export function read() {
  return count;
}

// index.mjs
export { increment, read } from "./counter.mjs";

// main.mjs
import { increment, read } from "./index.mjs";
console.log(read());
increment();
console.log(read());

Resultado

0
1

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