はじめに
TypeScriptで別ファイルに切り出した型定義をimportしようとしたらエラーが出て解決に時間がかかったのでエラーの原因と解決方法をまとめます。
エラーが出た状況
- Vite 8.3.6
- React 19.3.1
- TypeScript 6.0.3
複数箇所で使用している型定義があったので別ファイルに切り出して名前付きexportしました。
export type User = {
id: number,
name: string
};
上記の型定義を以下のファイルでimportしています。
import { User } from "./types/user";
export const UserProfile = ({id, name}: User) => {
return (
<>
<p>{`ユーザーid:${id}`}</p>
<p>{`ユーザー名:${name}`}</p>
</>
);
};
ここでimportが失敗してブラウザのコンソールに以下のエラーが出ました。
Uncaught SyntaxError: The requested module '/src/types/user.ts' does not provide an export named 'User'
エラーの内容は指定されたモジュールにUserというエクスポートが無いというものです。
エラーの原因
tsconfig.app.jsonとtsconfig.node.jsonにあるverbatimModuleSyntaxがtrueになっている場合は型定義のimportにimport typeを付ける必要がありました。
"verbatimModuleSyntax": true
verbatimModuleSyntaxとは
verbatimModuleSyntaxはTypeScript5.0から導入されたimport / export 構文のトランスパイル(変換)の動作を制御するためのオプションです。
verbatimModuleSyntaxが有効な場合はimport typeでimportしたモジュールの型の記述が削除されるようになり、通常のimportをしたモジュールの型の情報は削除されません。モジュール側のexportも同様にexport typeを付けた型のみ削除されます。
従来のTypeScriptはJavaScriptへトランスパイルする際に型の情報をすべて削除し、JavaScriptのコードだけを残していました。
verbatimModuleSyntaxが導入されたことで、typeの有無でどのimport / exportが削除され、どれが残るかがコードを見ただけで明確になり、モジュールの副作用(予期せぬコードの実行)によるトラブルを防げるようになりました。
またビルド時にimport typeがあることで、不要なコードの判別が高速で出来るようになるメリットもあるようです。
ちなみにViteはデフォルトでverbatimModuleSyntaxが有効になっているみたいです。
解決
型定義のみが記述されているモジュールのimportのため、import typeを付けたことで解決しました。
import type { User } from "./types/user"
今回のエラーはexport typeで型定義が削除されていたモジュールを通常のimportをしたため、ブラウザが何も記述が無い空のモジュールからUserを読み込もうとして見つけられなかったからでした。
終わりに
修正方法自体はtypeを付けるだけで単純なものでしたが、TypeScriptのトランスパイルが関わっているなど割と深いもので勉強になりました。
