Kategoria: Next.js, React i TypeScript

TypeScript TS7053: string nie może indeksować zdefiniowanego obiektu

Poradnik techniczny · Kacper Bernecki

Odczyt translations[key] nie przechodzi kompilacji, gdy key ma typ string, a obiekt tylko skończone klucze. Dowolny string nie musi być dozwolonym kluczem mapy, dlatego TypeScript blokuje niezweryfikowany odczyt.

Jak rozpoznać źródło problemu

Porównaj typ key i keyof typeof translations oraz skąd pochodzi klucz z parametru trasy. Sprawdź, czy zestaw dozwolonych wartości jest rzeczywiście zamknięty czy ma być słownikiem otwartym.

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

Kroki naprawcze

Zawęź key do keyof typeof translations po walidacji wejścia lub zastosuj type guard sprawdzający obecność klucza. Dla rzeczywiście dynamicznych map zadeklaruj Record<string,T> i przewidziany fallback przy brakującym kluczu.

Jak przetestować rozwiązanie

Kompilator akceptuje odczyt, a nieznany parametr nie prowadzi do renderowania undefined.

Bezpieczeństwo i ograniczenia

Nie rzutuj niezweryfikowanego parametru URL na keyof tylko po to, by wyciszyć błąd.