0Pricing
React Academy · Lekcja

Utrwalanie stanu za pomocą middleware persist

Synchronizowanie stanu Zustand z localStorage lub sessionStorage za pomocą middleware persist.

Utrwalanie stanu za pomocą middleware persist to bezpłatna lekcja React Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej React Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs React Academy zawiera 4 lekcji w sumie.

Witamy

W tej lekcji użyjesz middleware persist w Zustand, aby automatycznie synchronizować stan store'a z localStorage, dzięki czemu przetrwa on przeładowanie strony.

Dlaczego zachowywać stan?

Bez trwałego przechowywania cały stan store'a jest resetowany po odświeżeniu strony przez użytkownika. Zapisywanie w localStorage takich danych jak elementy koszyka, preferencje użytkownika czy stan interfejsu, na przykład otwarte panele, zapewnia płynne korzystanie z aplikacji między sesjami.

Middleware persist

Owiń wywołanie create() w persist(). Podaj unikalny klucz magazynu. Zustand automatycznie odczyta dane z localStorage podczas montowania i zapisze je po każdej zmianie stanu.
import { create } from 'zustand';
import { persist } from 'zustand/middleware';

const useCartStore = create(
  persist(
    (set) => ({
      items: [],
      addItem: (item) => set(s => ({ items: [...s.items, item] })),
    }),
    { name: 'cart-storage' } // localStorage key
  )
);

Częściowe przechowywanie za pomocą partialize

Użyj `partialize`, aby przechowywać tylko określone fragmenty store'a. Dzięki temu dane tymczasowe, takie jak flagi ładowania, nie trafią do localStorage.
persist(
  (set) => ({ user: null, token: null, loading: false, fetch: () => {} }),
  {
    name: 'auth-storage',
    partialize: (state) => ({ user: state.user, token: state.token }),
    // loading and fetch are NOT persisted
  }
)

Używanie sessionStorage

Aby przechowywać dane tylko w ramach sesji przeglądarki, czyli usuwać je po zamknięciu karty, przekaż `createJSONStorage(() => sessionStorage)` jako opcję magazynu.
import { createJSONStorage } from 'zustand/middleware';

persist(storeCreator, {
  name: 'session-data',
  storage: createJSONStorage(() => sessionStorage),
})

Wersjonowanie i migracja

Gdy struktura store'a się zmieni, na przykład pojawią się nowe pola lub zmienią się nazwy kluczy, ustaw numer `version` i udostępnij funkcję `migrate`, aby zaktualizować wcześniej zapisane dane.
persist(storeCreator, {
  name: 'my-store',
  version: 2,
  migrate: (persistedState, version) => {
    if (version === 1) {
      return { ...persistedState, newField: 'default' };
    }
    return persistedState;
  },
})

Hydratacja i SSR

Na serwerze (Next.js) localStorage nie istnieje. Middleware persist w Zustand obsługuje to bezpiecznie — pomija hydratację na serwerze i ponownie nawodnia stan po zamontowaniu na kliencie.

Callback onRehydrateStorage

Użyj `onRehydrateStorage`, aby uruchomić kod po przywróceniu store'a z magazynu. Jest to przydatne na przykład do wywołania API po przywróceniu tokenu.
persist(storeCreator, {
  name: 'auth',
  onRehydrateStorage: () => (state) => {
    if (state?.token) state.fetchUser();
  },
})

Usuwanie zachowanego stanu

Wywołaj `useMyStore.persist.clearStorage()`, aby usunąć zapisane dane z localStorage — jest to przydatne podczas wylogowywania.
const handleLogout = () => {
  useAuthStore.persist.clearStorage();
  useAuthStore.setState({ user: null, token: null });
};

Limity rozmiaru magazynu

localStorage ma limit od 5 do 10 MB na origin. Unikaj zapisywania dużych zbiorów danych, takich jak pełne katalogi produktów. Przechowuj tylko identyfikatory lub małe obiekty konfiguracyjne.

Szybkie sprawdzenie

Jaka opcja middleware persist pozwala wykluczyć określone pola stanu z zapisywania w localStorage?

Podsumowanie

Owiń store Zustand w persist() i podaj klucz name. Użyj partialize, aby przechowywać tylko istotne fragmenty stanu. Wersjonuj dane i przeprowadzaj migrację po zmianie struktury store'a. Podczas wylogowywania używaj clearStorage().

Dalej

Następna lekcja: **DevTools Zustand i testowanie store'ów** — połączysz się z Redux DevTools i napiszesz testy jednostkowe akcji Zustand.

Często zadawane pytania

Czy lekcja „Utrwalanie stanu za pomocą middleware persist” jest bezpłatna?

Tak — pełny tekst „Utrwalanie stanu za pomocą middleware persist” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu React Academy, przejdź na CoddyKit PRO. Kurs React Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Utrwalanie stanu za pomocą middleware persist”?

Synchronizowanie stanu Zustand z localStorage lub sessionStorage za pomocą middleware persist. Ćwiczysz React Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć React Academy?

Nie wymagamy żadnego doświadczenia. React Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Utrwalanie stanu za pomocą middleware persist”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji React Academy?

Tak. Każda lekcja React Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Tworzenie pierwszego store Zustand
  2. Selektory i zapobieganie zbędnym ponownym renderowaniom
  3. Utrwalanie stanu za pomocą middleware persist
  4. Zustand DevTools i testowanie store'ów
← Powrót do React Academy