O percurso das importações
Um bundler é uma ferramenta que resolve as dependências entre os módulos de uma aplicação e gera arquivos para distribuição. A partir de uma ou mais entradas, ele acompanha as importações e constrói um grafo de dependências, que registra quais módulos utilizam outros módulos.
O webpack, por exemplo, usa esse grafo para reunir o código necessário na saída. Arquivos de outros tipos podem exigir transformações configuradas, como um loader para interpretar uma extensão que a ferramenta não processa diretamente.
Dois módulos na origem
Neste exemplo didático, principal.js importa uma função de dobro.js. A configuração usa principal.js como entrada e gera JavaScript para o navegador.
export function dobro(valor) { return valor * 2}
// principal.jsimport { dobro } from './dobro.js'console.log(dobro(4))O bundler encontra a importação e inclui o módulo necessário na saída. Quando o código gerado é executado, a chamada escreve 8 no console. O agrupamento preserva a ligação entre a importação e a implementação usada no cálculo.
A saída pode ter vários arquivos
Uma importação dinâmica com import() pode separar uma parte da aplicação para carregamento posterior. O número de arquivos gerados depende dessa divisão e das opções do bundler. Dois módulos de origem não significam necessariamente duas requisições do navegador.
Você pode comparar o relatório do build com as requisições na aba de rede do navegador para descobrir quais arquivos a página carregou. Uma importação que não foi resolvida exige conferir o caminho e a configuração de resolução. A minificação pode ocorrer no mesmo build, mas tem outra função: reduzir o texto do código produzido.
Dúvidas frequentes
Perguntas frequentes sobre bundler
- Um bundler sempre gera um único arquivo?
- A saída pode conter vários arquivos. A divisão de código permite separar módulos para carregamento posterior ou compartilhar dependências entre partes da aplicação.
- Agrupar módulos e minificar são a mesma transformação?
- O agrupamento resolve e reúne os módulos. A minificação reduz o texto do código preservando seu comportamento. Um mesmo build pode executar as duas transformações.
- O navegador precisa receber cada arquivo de origem?
- O navegador recebe os arquivos gerados e utilizados pela página. Eles podem reunir vários módulos de origem ou separar uma parte para carregamento posterior, conforme a configuração.
Para continuar
Recursos relacionados
Documentação
webpack: entradas, dependências e saída
Explica como as entradas dão origem ao grafo de dependências e aos arquivos gerados.
Abrir recursoDocumentação
webpack: divisão de código
Mostra como produzir arquivos separados e utilizar importações dinâmicas.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Você pode investigar uma importação não resolvida ou uma falha de carregamento com orientação ao vivo no Desenvolvimento Colaborativo da Dev Side Studio.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A investigação de falhas no build exige compreender como as importações se tornam arquivos carregados pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.