Kategoria: Next.js, React i TypeScript

Next.js: window is not defined podczas SSR komponentu

Poradnik techniczny · Kacper Bernecki

Aplikacja działa przy nawigacji klienta, lecz odświeżenie strony kończy się błędem window is not defined. Obiekt window nie istnieje w środowisku renderowania serwerowego; import biblioteki może wykonywać kod natychmiast.

Jak ustalić źródło błędu

Sprawdź, czy odczyt window następuje w górnym zakresie modułu, podczas renderowania lub wewnątrz biblioteki.

Zlokalizuj import, po którym zaczyna się błąd, i sprawdź jego zgodność z SSR.

Co zrobić krok po kroku

1. Przenieś kod wymagający window do useEffect uruchamianego w przeglądarce albo do komponentu ładowanego wyłącznie po stronie klienta.

2. Jeśli biblioteka nie wspiera SSR, rozdziel jej integrację od reszty strony i dodaj bezpieczny widok zastępczy.

Jak sprawdzić wynik

Bezpośrednie otwarcie i odświeżenie strony działa bez błędu; funkcja przeglądarkowa nadal działa po hydracji.

Czego nie robić

Nie używaj typeof window w przypadkowych miejscach, jeśli sam import powoduje wyjątek wcześniej.