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.