Gestión de Estado
Prioridad: P2 (MEDIA)
Pautas de Implementación
- Estado de URL: Usa la URL como Fuente Única de Verdad para estado compartible/persistente. Los parámetros de URL son compartibles entre recargas y enlaces. Accede mediante
useSearchParams()y actualiza conuseRouter(). Patrón:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - Estado del Servidor: Usa SWR o TanStack Query (React Query) para cachear y obtener datos del servidor. Evita sincronizar manualmente datos del servidor en
useState. - Estado del Cliente: Usa Zustand (
create<CartState>()((set) => ({ ... }))) — úsalo solo en componentes 'use client' — o Jotai para estado UI complejo y de alta frecuencia. Evita el Prop Drilling utilizando Context API solo para datos de baja frecuencia. - Levantamiento de Estado: Coloca el estado lo más cerca posible del componente. Solo levántalo al padre cuando el estado se comparta entre hermanos.
- Integración con Next.js 15+: Asegúrate de que las actualizaciones de estado en Componentes Cliente no entren en conflicto con la lógica de renderizado del lado del servidor. Gestiona actualizaciones optimistas con el hook
useOptimistic. - Hidratación de Estado: Ten cuidado al inicializar estado desde
localStorageen Componentes Cliente para evitar Errores de Hidratación. Envuélvelo enuseEffecto usa una banderamounted.
2. Estado Impulsado por URL (Búsqueda/Filtro)
Usa useSearchParams + useRouter para actualizar los parámetros de URL. Consulta Patrón de Estado de URL.
3. Estado del Servidor (TanStack Query / SWR)
Si necesitas datos "en vivo" en el cliente (por ejemplo, sondeo de precios de acciones, chat), no implementes la obtención manual con useEffect. Usa una librería.
// Caché automática, deduplicación y revalidación con refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
Patrones de Librerías
Para patrones específicos de gestión de estado, consulta:
Antipatrones
- No uses store global para estado simple: Usa
useStateo parámetros de URL; evita Zustand para UI básica. - No guardes objetos grandes en el estado: Descompón en primitivas granulares para evitar re-renderizados extra.
- No uses
useEffectpara obtener datos: Usa SWR o TanStack Query para estado del servidor. - No almacenes estado del servidor en stores del cliente: Obtén los datos en Componentes del Servidor de React (RSC); los stores del cliente son solo para estado UI.