ExpertiDict

JavaScript · Intermediário · Português · Técnico

import dinâmico

/ĩˈpɔɾtʃ dʒiˈnɐ̃miku/substantivo

Chamada import() que carrega um módulo sob demanda e devolve uma promise com o módulo. Aceita caminho calculado em tempo de execução e funciona também em arquivos CommonJS.

Onde usar

Usado para carregar código pesado só quando precisa, como a rota de um painel, reduzindo o bundle inicial. Em code review, também permite usar um pacote ESM a partir de código CommonJS.

Em código

async function abrir() {
  const mod = await import('./grafico.js');
  mod.desenhar();
}
// o módulo só é carregado nesta chamada
abrir();

Exemplos

Carregamos o gráfico com import dinâmico só quando o usuário abre a aba.

Dá para usar um pacote ESM em código CommonJS com import dinâmico.

Cuidado

Confundir com a declaração import estática: import() é uma expressão que devolve promise, então exige await ou then.

Sinônimos

dynamic import, import()

Antônimos

import estático

Veja também

Todos os termos de JavaScript