Come si persist e hydrate lo stato?

Question

Accepted Answer

**Persisting** lo stato significa salvarlo in una memoria (localStorage, IndexedDB, un backend) in modo che sopravviva ai ricaricamenti della pagina o alle sessioni; **hydrating** significa caricarlo di nuovo nell'app all'avvio. Comune per carrelli, token di autenticazione, preferenze utente e moduli in bozza.

## Persist e hydrate di base con localStorage

```jsx
function useCart() {
  // HYDRATE: initialize from storage (lazy initializer runs once)
  const [cart, setCart] = useState(() => {
    try {
      const saved = localStorage.getItem("cart");
      return saved ? JSON.parse(saved) : [];      // parse stored JSON
    } catch {
      return [];                                   // guard against corrupt data
    }
  });

// PERSIST: write to storage whenever it changes
  useEffect(() => {
    localStorage.setItem("cart", JSON.stringify(cart));
  }, [cart]);

return [cart, setCart];
}
```

I due step: leggere e parsare all'init (hydrate), e serializzare e scrivere al cambio (persist).

## Supporto delle librerie

```js
// Zustand persist middleware — automatic persist + hydrate
const useStore = create(persist((set) => ({ ... }), { name: "app-store" }));

// redux-persist for Redux; both handle serialization + rehydration
```

## Scegliere la memoria

```text
localStorage  → simple, synchronous, ~5–10MB, strings only (JSON) — preferences, small state
sessionStorage→ like localStorage but cleared when the tab closes
IndexedDB     → large/structured data, async — offline apps, big caches
Cookies       → sent to server; for auth (httpOnly for security)
Backend       → cross-device sync, source of truth for important data
```

## Le caveat importanti

```text
⚠️ SSR mismatch: localStorage doesn't exist on the server → guard with typeof window,
   and beware hydration mismatches between server-rendered and client state.
⚠️ Versioning/migration: stored shape may differ from new code → version it and migrate.
⚠️ Don't persist sensitive data (tokens) in localStorage (XSS-readable) — prefer httpOnly cookies.
⚠️ Don't persist server state you can refetch (let React Query handle caching).
⚠️ Validate/guard on hydrate — stored data can be stale or corrupt.
```

## Perché è importante

La persistenza offre valore UX reale — i carrelli sopravvivono ai ricaricamenti, le preferenze e le bozze non vengono perse, gli utenti rimangono connessi.

Ma un'implementazione ingenua introduce problemi sottili e seri: disadattamenti di hydration SSR, dati stantii/corrotti, rotture della migrazione dello schema, e **rischi di sicurezza** (persistenza di token in memoria leggibile da XSS).

Conoscere il pattern persist/hydrate, scegliere la memoria giusta per i dati, e rispettare le caveat (proteggere per SSR, versionare lo schema, non archiviare segreti in modo non sicuro, non persistere lo stato del server scaricabile di nuovo) è ciò che rende la persistenza robusta piuttosto che una fonte di bug difficili da diagnosticare.