Kategoria: Next.js, React i TypeScript

TypeScript: nowa wartość enum omija niepełny switch

Poradnik techniczny · Kacper Bernecki

Po dodaniu nowego statusu zamówienia jedna gałąź UI wyświetla pusty tekst, choć build przechodzi. Kod switch nie sprawdza wyczerpująco wszystkich wariantów typu union i nowa wartość przechodzi niezauważona.

Jak rozpoznać źródło problemu

Przejrzyj definicję union statusów i wszystkie funkcje mapujące status na etykietę i uprawnienia. Sprawdź przypadek default i czy zwraca cichy undefined dla nieznanej wartości.

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

Kroki naprawcze

Użyj sprawdzania wyczerpującego z parametrem never w gałęzi default lub funkcji assertNever. Dodaj test pokrywający wszystkie dopuszczalne statusy oraz zachowanie przy nieoczekiwanych danych z API.

Jak przetestować rozwiązanie

Dodanie nowego statusu wymusza poprawienie mapowania w typecheck, a obecne wartości dają właściwe etykiety.

Bezpieczeństwo i ograniczenia

Nie wpisuj domyślnej etykiety „OK” dla nieznanego statusu, bo maskuje błąd przepływu.