Kategoria: Next.js, React i TypeScript

TypeScript TS18046: zmienna error ma typ unknown w catch

Poradnik techniczny · Kacper Bernecki

Kod catch(error) nie pozwala odczytać error.message mimo że w konsoli widać Error. JavaScript pozwala rzucać dowolną wartość, więc TypeScript nie zakłada, że schwytany obiekt jest instancją Error.

Jak rozpoznać źródło problemu

Sprawdź wszystkie miejsca catch i to, czy zewnętrzne biblioteki zwracają inne kształty wyjątków. Ustal, jakie informacje mogą trafić do logu, a jakie są sekretami lub danymi klienta.

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

Kroki naprawcze

Użyj if(error instanceof Error) przed dostępem do message i przygotuj bezpieczny komunikat dla innych wartości. Dla błędów dostawcy opracuj osobny walidator kształtu odpowiedzi i nie ujawniaj całego payloadu użytkownikowi.

Jak przetestować rozwiązanie

Typecheck działa, a komunikat nie wyświetla poufnych fragmentów błędu z API.

Bezpieczeństwo i ograniczenia

Nie zmieniaj globalnie catch na any bez potrzeby, bo traci się walidację rodzaju wyjątku.