Kategoria: Next.js, React i TypeScript

TypeScript TS2532: Object is possibly undefined w danych API

Poradnik techniczny · Kacper Bernecki

Typecheck zgłasza możliwość undefined przy odczycie właściwości obiektu pobieranego asynchronicznie. Typ dopuszcza brak wartości, więc bezwarunkowy odczyt może rzeczywiście spowodować błąd w runtime.

Jak rozpoznać źródło problemu

Sprawdź rzeczywisty typ response i czy API ma opcjonalne pola oraz stan początkowy null lub undefined. Ustal, jak UI powinien wyglądać przed zakończeniem fetch oraz dla odpowiedzi bez danych.

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

Kroki naprawcze

Dodaj warunek zawężający typ albo bezpieczne optional chaining z jawną obsługą braku informacji. Jeśli pole jest wymagane, waliduj dane wejściowe na granicy API zamiast bezpodstawnie używać operatora !.

Jak przetestować rozwiązanie

Typecheck przechodzi, a brak danych pokazuje przewidziany pusty stan bez wyjątku.

Bezpieczeństwo i ograniczenia

Nie wpisuj as any w każdym miejscu, ponieważ usuwa to potrzebne ostrzeżenie o brakującym polu.