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

CKTIS / JavaScript

import — importar módulos JavaScript

A palavra-chave import disponibiliza exports de outros módulos. Saiba como funcionam as declarações estáticas e as ligações vivas, e em que diferem import(...), import.meta e as chamadas de função comuns.

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

import defaultExport from "module";
import { namedExport, otherExport as localName } from "module";
import * as namespace from "module";
import "module";
import(specifier);
import.meta

import é uma palavra-chave reservada: não pode ser usada como nome de variável. Uma declaração estática import só aparece no nível superior de um módulo, não dentro de uma função ou de um bloco. O especificador do módulo tem de ser um literal de cadeia de caracteres. Os imports estáticos fazem parte do sistema de módulos introduzido no ECMAScript 2015.

Um import predefinido seleciona o export default; um import nomeado seleciona um export específico, e as atribui-lhe um nome local. A forma import * as namespace cria uma ligação local ao objeto de espaço de nomes do módulo. import "module" executa a dependência sem criar ligações locais. As ligações importadas são vivas: refletem as alterações feitas pelo módulo que exporta. O módulo que importa não lhes pode atribuir um novo valor; isso não significa, contudo, que um objeto importado esteja congelado.

import(specifier) é uma sintaxe distinta de importação dinâmica, introduzida no ECMAScript 2020, e não uma função comum. Pode surgir em expressões, incluindo num script normal, e devolve uma Promise. Depois de o módulo ser carregado e avaliado com êxito, a promessa é normalmente cumprida com o objeto de espaço de nomes do módulo. No entanto, se o módulo exportar um valor invocável com o nome then, o mecanismo de resolução da promessa invoca-o. A promessa pode então ser cumprida com outro valor ou ser rejeitada, mesmo que o módulo tenha sido avaliado com êxito. import.meta, também do ECMAScript 2020, expõe metadados do módulo dependentes do ambiente anfitrião e só é permitido em módulos.

A resolução dos especificadores e o carregamento dos módulos dependem do ambiente anfitrião. Nem a especificação da linguagem, por si só, nem uma execução bem-sucedida no Node.js comprovam o suporte num navegador específico. O exemplo demonstra uma ligação viva: a chamada a increase() altera o valor observado através de count.

Exemplos

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

// main.mjs
import { count, increment as increase } from "./counter.mjs";

console.log(count);
increase();
console.log(count);

Resultado

1
2

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