Kategoria: Next.js, React i TypeScript

TypeScript: import must be type-only przy verbatimModuleSyntax

Poradnik techniczny · Kacper Bernecki

Kompilator odrzuca import interfejsu, który miał być używany wyłącznie jako typ. Przy verbatimModuleSyntax TypeScript wymaga poprawnego rozdzielenia importów wartości i typów.

Jak ustalić źródło błędu

Sprawdź tsconfig pod kątem verbatimModuleSyntax i pliki wskazane przez TS1484.

Ustal, czy importowany symbol istnieje w runtime czy jest tylko aliasem lub interfejsem.

Co zrobić krok po kroku

1. Zamień odpowiedni import na import type { ... } from '...' lub oznacz pojedyncze nazwy jako type.

2. Zostaw zwykłe importy dla wartości wykorzystywanych podczas działania JavaScriptu.

Jak sprawdzić wynik

Typecheck nie zgłasza TS1484, a wynikowy JavaScript nie zawiera importów nieistniejących typów.

Czego nie robić

Nie wyłączaj konfiguracji TS tylko po to, by uniknąć poprawienia kilku importów.