State Management
Priorität: P2 (MITTEL)
Implementierungsrichtlinien
- URL-State: Verwenden Sie die URL als einzige Quelle der Wahrheit für teilbaren/persistenten Zustand. URL-Parameter: teilbar über Neuladevorgänge und Links hinweg. Zugriff über
useSearchParams()und Aktualisierung mituseRouter(). Muster:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - Server-State: Verwenden Sie SWR oder TanStack Query (React Query) zum Caching und Abrufen von Serverdaten. Synchronisieren Sie Serverdaten nicht manuell in
useState. - Client-State: Verwenden Sie Zustand (
create<CartState>()((set) => ({ ... }))) — nur in 'use client'-Komponenten — oder Jotai für komplexen, hochfrequenten UI-Status. Vermeiden Sie Prop Drilling, indem Sie die Context-API nur für niederfrequente Daten nutzen. - State anheben: Colokalisieren Sie State so nah wie möglich an der Komponente. Heben Sie State nur dann zum Elternteil an, wenn er zwischen Geschwisterkomponenten geteilt wird.
- Next.js 15+ Integration: Stellen Sie sicher, dass State-Updates in Client-Komponenten nicht mit der serverseitigen Rendering-Logik kollidieren. Verwalten Sie optimistische Updates mit dem
useOptimistic-Hook. - State-Hydration: Seien Sie vorsichtig, wenn Sie State aus
localStoragein Client-Komponenten initialisieren, um Hydrationsfehler zu vermeiden. Wickeln Sie dies inuseEffectoder verwenden Sie einmounted-Flag.
2. URL-gesteuerter State (Suche/Filter)
Verwenden Sie useSearchParams + useRouter, um URL-Parameter zu aktualisieren. Siehe URL-State-Muster.
3. Server-State (TanStack Query / SWR)
Wenn Sie „Live“-Daten auf dem Client benötigen (z. B. Polling von Aktienkursen, Chat), implementieren Sie kein manuelles useEffect-Fetching. Verwenden Sie eine Bibliothek.
// Automatisiertes Caching, Deduplizierung und Revalidierung mit refreshInterval
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
Bibliotheksmuster
Spezifische Muster für die State-Verwaltung finden Sie unter:
Anti-Patterns
- Kein globaler Store für einfachen State: Verwenden Sie
useStateoder URL-Parameter; vermeiden Sie Zustand für einfaches UI. - Keine großen Objekte im State: Zerlegen Sie in granulare Primitive, um unnötige Re-Renders zu vermeiden.
- Kein
useEffectzum Datenabruf: Verwenden Sie SWR oder TanStack Query für Server-State. - Kein Server-State in Client-Stores: Rufen Sie in RSCs ab; Client-Stores sind nur für UI-Status gedacht.