Kategoria: Next.js, React i TypeScript

React Error Boundary nie łapie odrzuconego Promise w kliknięciu

Poradnik techniczny · Kacper Bernecki

Po błędzie podczas zapisu formularza Error Boundary nie wyświetla fallbacku, a konsola pokazuje unhandled rejection. Granica błędów React dotyczy renderowania i wybranych faz komponentów, nie wszystkich błędów z handlerów czy zadań async.

Jak rozpoznać źródło problemu

Sprawdź, w którym miejscu powstaje błąd: render, event handler, useEffect czy Promise w API. Porównaj zachowanie po celowym throw w renderze z błędem odrzuconego fetch wewnątrz onClick.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

W obsłudze zdarzenia zastosuj try/catch, kontrolowany stan błędu i czytelny komunikat użytkownika. Użyj Error Boundary dla awarii renderowania, a błędy transportowe i walidacyjne obsługuj w warstwie formularza.

Jak przetestować rozwiązanie

Błąd API pokazuje komunikat w formularzu, a błąd renderowania osobny fallback, bez białego ekranu.

Bezpieczeństwo i ograniczenia

Nie zakładaj, że jeden Error Boundary zastępuje obsługę wszystkich asynchronicznych wyjątków.