Pular para o conteúdo

Code splitting por rota no React: carregue só o que a página precisa

O visitante abre a página inicial e baixa o código do painel administrativo inteiro. Veja como dividir o JavaScript por rota no React.

Por Roger C. Ribeiro, fundador da Wecodex3 min de leitura

O visitante abre a página inicial e baixa o código do painel administrativo inteiro. Veja como dividir o JavaScript por rota no React.

Em muitas aplicações React, todo o código vai num arquivo só. Quem abre a página inicial baixa também o checkout, o painel, os gráficos e o editor de texto — telas que talvez nunca visite. É o caminho mais curto para LCP e INP ruins.

Dividir por rota

tsx
import { lazy } from 'react'
const Painel = lazy(() => import('./pages/Painel'))

Cada página vira um arquivo separado, baixado quando o usuário navega até ela. Com React Router, o carregamento pode ser feito pelo próprio roteador antes de trocar de tela, sem tela em branco.

Dividir bibliotecas pesadas

  • Gráficos, mapas, editores e 3D: carregue só na tela que usa.
  • Bibliotecas de data, ícones e utilitários: importe apenas as funções necessárias.

Cuidado com a experiência

Dividir não pode significar "piscar" a cada navegação. Pré-carregue a próxima rota provável (quando o mouse passa sobre o link, por exemplo) e mostre skeletons no lugar de telas vazias (Skeleton screens no lugar de spinners: por que trocar).

Como saber se funcionou

Ferramentas de análise de bundle mostram o tamanho de cada arquivo e o que há dentro — o processo está em Bundle JavaScript pesado: como descobrir quem está engordando o seu site. Depois, confira o efeito real no Core Web Vitals (Core Web Vitals em React e React Native: o que ajustar primeiro).

Uma escolha de base

Frameworks como Next.js fazem a divisão por rota automaticamente; com Vite, você configura. A comparação está em Next.js ou Vite: qual escolher no seu próximo projeto.

Este site usa divisão por rota e carrega o 3D separadamente. Veja Performance WPO ou fale com a gente.

  • React
  • Code splitting
  • Performance
  • Vite
CompartilharWhatsAppLinkedIn

Escrito por

Roger C. Ribeiro

Fundador da Wecodex. Escreve sobre engenharia de software, performance, APIs, segurança e IA aplicada a empresas.

Serviços relacionados

Resolver de vez, com quem faz isso todo dia

Seu site precisa carregar em menos de um segundo e converter mais?

Este artigo mostra o caminho. A implementação sob medida, o detalhe que muda o resultado no seu caso, é o trabalho da Wecodex, empresa de engenharia do grupo Wocom.