Como você persiste e hidrata o estado?

Question

Accepted Answer

**Persistir** estado significa salvá-lo em armazenamento (localStorage, IndexedDB, um backend) para que ele sobreviva a recarregamentos de página ou sessões; **hidratar** significa carregá-lo de volta no aplicativo na inicialização. Comum para carrinhos, tokens de autenticação, preferências do usuário e formulários em rascunho.

## Persiste básico + hidrate com 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];
}
```

Duas metades: ler-e-analisar na inicialização (hidratar), e serializar-e-escrever na mudança (persistir).

## Suporte de biblioteca

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

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

## Escolhendo armazenamento

```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
```

## As ressalvas importantes

```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.
```

## Por que isso importa

A persistência entrega valor real de UX — carrinhos sobrevivem a recarregamentos, preferências e rascunhos não são perdidos, usuários permanecem conectados.

Mas a implementação ingênua introduz problemas sutis e graves: incompatibilidades de hidratação do SSR, dados obsoletos/corrompidos, quebra de migração de esquema e **riscos de segurança** (persistência de tokens em armazenamento legível por XSS).

Conhecer o padrão persista/hidrate, escolher o armazenamento certo para os dados e respeitar as ressalvas (proteger para SSR, versionar o esquema, não armazenar segredos com segurança, não persistir estado de servidor refetchable) é o que torna a persistência robusta em vez de uma fonte de bugs difíceis de diagnosticar.