Kategoria: Next.js, React i TypeScript

TypeScript TS1259 default import bez esModuleInterop

Poradnik techniczny · Kacper Bernecki

Import domyślny biblioteki CommonJS kończy się błędem TS1259 dotyczącym zgodności modułów. Wybrany moduł eksportuje kształt niezgodny z deklaracją domyślnego importu w bieżącym trybie kompilacji.

Jak rozpoznać źródło problemu

Sprawdź dokumentację importu i deklaracje .d.ts danej biblioteki oraz ustawienia module i esModuleInterop. Porównaj wynik transpilacji z prawdziwym środowiskiem Node lub bundlerem używanym przez aplikację.

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

Kroki naprawcze

Zastosuj zgodną składnię importu lub świadomie włącz interoperacyjność w tsconfig dla całego projektu. Po zmianie przetestuj import w runtime, szczególnie przy mieszaniu require, import i NodeNext.

Jak przetestować rozwiązanie

Kompilator i uruchomiony kod odczytują właściwy eksport, a nie undefined.default.

Bezpieczeństwo i ograniczenia

Nie zmieniaj na oślep systemu modułów całej aplikacji dla jednej paczki bez testów.