Gerenciamento de Estado
Prioridade: P2 (MÉDIA)
Diretrizes de Implementação
- Estado de URL: Use a URL como Fonte Única da Verdade para estado compartilhável/persistente. Parâmetros de URL: compartilháveis entre recarregamentos e links. Acesse via
useSearchParams()e atualize comuseRouter(). Padrão:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - Estado de Servidor: Use SWR ou TanStack Query (React Query) para caching e busca de dados do servidor. Evite sincronizar dados do servidor manualmente no
useState. - Estado de Cliente: Use Zustand (
create<CartState>()((set) => ({ ... }))) — use apenas em componentes 'use client' — ou Jotai para estado UI complexo e de alta frequência. Evite Prop Drilling utilizando Context API apenas para dados de baixa frequência. - Elevação de Estado: Cole o estado o mais próximo possível do componente. Eleve apenas para o pai quando o estado for compartilhado entre irmãos.
- Integração Next.js 15+: Garanta que as atualizações de estado em Componentes Cliente não conflitem com a lógica de renderização do lado do servidor. Gerencie atualizações otimistas com o hook
useOptimistic. - Hidratação de Estado: Tenha cuidado ao inicializar o estado a partir de
localStorageem Componentes Cliente para evitar Erros de Hidratação. Envolva emuseEffectou use uma flagmounted.
2. Estado Orientado por URL (Pesquisa/Filtro)
Use useSearchParams + useRouter para atualizar parâmetros de URL. Veja Padrão de Estado de URL.
3. Estado de Servidor (TanStack Query / SWR)
Se você precisar de dados "ao vivo" no cliente (por exemplo, consultar preços de ações com polling, chat), não implemente busca manual com useEffect. Use uma biblioteca.
// Cache, deduplicação e revalidação automatizados com refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
Padrões de Biblioteca
Para padrões específicos de gerenciamento de estado, veja:
Anti-Padrões
- Sem store global para estado simples: Use
useStateou parâmetros de URL; evite Zustand para UI básica. - Sem objetos grandes no estado: Decomponha em primitivas granulares para evitar re-renderizações extras.
- Sem
useEffectpara busca de dados: Use SWR ou TanStack Query para estado de servidor. - Sem estado de servidor em stores do cliente: Busque em RSCs; stores do cliente são apenas para estado de UI.