JavaScriptの「does not provide an export named」の直し方

​​JavaScript​ES Modules,Vite,トラブルシュート

ブラウザーのコンソールに does not provide an export named 'xxx' と出るのは、import { xxx } from ... で読み込もうとした名前を、相手のモジュールが export していないときです。この記事では、名前の打ち間違いと、export default と名前付きの export の取り違えの2つで試しました。どちらも、import の書き方を相手の export に合わせると消えました。

Vite で作った画面を開発サーバーで開いたら、何も表示されず、コンソールに赤いエラーが1件だけ出ていた、という場面の話です。私は検証環境でこのエラーをわざと起こし、出たメッセージを一字一句そのまま写し、直すと消えることを確かめました。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Vite 8.3.8 です。ブラウザーは Playwright 1.63.0 で起動した Chromium 153 で、コンソールのメッセージは DevTools プロトコルで取り出し、DevTools の画面も撮りました。Firefox や Safari での文言、TypeScript のファイル(.ts)から import する場合、webpack など Vite 以外のツールは試していません。

コンソールに出たエラーの全文

Vite のプロジェクトに、金額を「1,980 円」の形にする関数を書いた src/price.js と、それを使う src/main.js を置きました。main.js では、formatPrice を formatPrise と1文字打ち間違えています。

js
// src/price.js
export function formatPrice(yen) {
  return `${yen.toLocaleString('ja-JP')} 円`;
}
js
// src/main.js
import { formatPrise } from './price.js';

document.getElementById('out').textContent = formatPrise(1980);

index.html には <p id="out">(まだ表示されていません)</p> と、<script type="module" src="/src/main.js"> を書いています。開発サーバーを起動してページを開くと、Chromium の DevTools の Console パネルに次のように出ました。

text
Uncaught SyntaxError: The requested module '/src/price.js' does not provide an export named 'formatPrise' (at main.js:1:10)
DevTools の Console パネルに、赤い背景で Uncaught SyntaxError の行が1つ出ている画面
Chromium の DevTools に出たエラー(formatPrice を formatPrise と打ち間違えた場合)

「読み込もうとしたモジュール /src/price.js には、formatPrise という名前の export がない」という意味です。最後の (at main.js:1:10) は、main.js の1行目の10文字目、つまり import { formatPrise } の formatPrise の位置を指しています。

画面の文字は「(まだ表示されていません)」のまま変わりませんでした。main.js の本体は実行されていません。MDN のモジュールグラフの解説にある、リンク時のエラーの説明によると、import した名前が相手に見つからないときは、コードを実行する前の段階(リンク)で SyntaxError になり、どのモジュールの本体も実行されません。実行中に起きるエラーと違って、途中までは動く、ということがありません。

開発サーバーを起動したターミナルには、ページを開いたあとも何も出ませんでした。このエラーは、ブラウザーのコンソールで探します。

打ち間違いを直すと消える

main.js の2か所を、price.js が export している名前 formatPrice に直しました。

js
// src/main.js
import { formatPrice } from './price.js';

document.getElementById('out').textContent = formatPrice(1980);

開き直すと、エラーは出なくなり、画面に「1,980 円」と表示されました。

export default を { } で読もうとした場合

打ち間違いがないのに同じエラーが出るときは、export の種類が食い違っています。price.js を export default function formatPrice に変え、main.js は import { formatPrice } from './price.js' のままにすると、次のように出ました。

text
Uncaught SyntaxError: The requested module '/src/price.js' does not provide an export named 'formatPrice' (at main.js:1:10)

price.js の中に formatPrice という関数の名前は書いてあります。しかし、export default で出したものは default という名前の export になり、formatPrice という名前の export にはなりません。MDN の import 文の説明にも、default という名前を import するのは、default を読む import x from "mod" と同じだと書かれています。また、import { x } from "mod" と import x from "mod" は別の構文です。

default を読むときは、{ } を外します。

js
// src/main.js
import formatPrice from './price.js';

document.getElementById('out').textContent = formatPrice(1980);

これでエラーが消え、「1,980 円」と表示されました。

反対に、price.js が export function formatPrice(名前付き)のままで、main.js で import formatPrice from './price.js'(default を読む書き方)にすると、名前の部分が 'default' になりました。

text
Uncaught SyntaxError: The requested module '/src/price.js' does not provide an export named 'default' (at main.js:1:8)

メッセージの最後の '...' が 'default' なら「default を読もうとしたが、相手に default がない」、ほかの名前なら「その名前の export が相手にない」と読み分けられます。どちらの書き方に合わせるかは、相手のファイルの export の行を見て決めます。MDN の export 文の説明のとおり、名前付きの export は1つのモジュールにいくつでも置けます。読む側は、export と同じ名前で書きます(as で別名にもできます)。default は1つのモジュールに1つだけで、読む側が好きな名前を付けられます。

npm のパッケージで出た場合のメッセージ

npm で入れたパッケージから import した場合も、同じエラーになります。nanoid パッケージ(6.0.2)の nanoid を、nanoId と大文字を混ぜて書きました。

js
// src/main.js
import { nanoId } from 'nanoid';

document.getElementById('out').textContent = `ID: ${nanoId(8).length} 文字`;
text
Uncaught SyntaxError: The requested module '/node_modules/.vite/deps/nanoid.js?v=3ba6ec4d' does not provide an export named 'nanoId' (at main.js:1:10)

モジュールの部分が 'nanoid' ではなく、/node_modules/.vite/deps/nanoid.js?v=3ba6ec4d になっています。Vite の開発サーバーは、npm のパッケージを前もってまとめ直し(事前バンドル)、node_modules/.vite に置いて配るためです。置き場所は、Vite の公式ドキュメントの、事前バンドルのキャッシュの説明に書かれています。?v= の後ろの値は、検証の途中で設定ファイルを変えたあとは別の値になりました。自分の画面と違っていても気にしなくてかまいません。見るのは、deps/ の後ろのパッケージ名と、最後の '...' の名前です。

正しい名前は、エラーに出ているファイルの export の行で確かめられます。事前バンドルされた node_modules/.vite/deps/nanoid.js の export の行は、次の1行でした。

js
export { customAlphabet, customRandom, nanoid, random, urlAlphabet };

import { nanoid } from 'nanoid' に直すと、エラーは消え、画面に「ID: 8 文字」と表示されました。

ビルドすると、ターミナルで止まる

開発サーバーではブラウザーのコンソールにしか出ませんが、ビルド(vite build)を実行すると、ターミナルでエラーになって止まります。打ち間違いのままの main.js でビルドすると、終了コード 1 で、次のように出ました(前後の行は省略しています)。

text
✗ Build failed in 39ms
error during build:
Build failed with 1 error:

[MISSING_EXPORT] "formatPrise" is not exported by "src/price.js".
   ╭─[ src/main.js:1:10 ]
   │
 1 │ import { formatPrise } from './price.js';
   │          ─────┬─────  
   │               ╰─────── Missing export
───╯

export default を { } で読んだ場合も、同じ [MISSING_EXPORT] "formatPrice" is not exported by "src/price.js". で止まりました。どちらも、直したあとはビルドが通りました。開発サーバーの画面に何も出ず、コンソールを開くのが手間なときは、ビルドを一度実行すると、どのファイルの何行目かをターミナルで確かめられます。

ターミナルにもエラーを出したいとき

Vite 8 には、ブラウザーで起きたエラーを開発サーバーのターミナルにも出す server.forwardConsole という設定があります。公式ドキュメントによると、既定では、AI のコーディングエージェントの中で動いていると判断したときだけ有効になります。vite.config.js で true にすると、普通に起動したときも有効になります。

js
// vite.config.js
import { defineConfig } from 'vite';

export default defineConfig({
  server: {
    forwardConsole: true,
  },
});

この設定で打ち間違いのページを開くと、ターミナルに次の行が出ました。

text
4:00:30 AM [vite] (client) [Unhandled error] SyntaxError: The requested module '/src/price.js' does not provide an export named 'formatPrise'

設定を変えずに使う場合は、ブラウザーのコンソールを開くか、ビルドを実行して確かめます。

​Posted by 86