JavaScriptの「does not provide an export named」の直し方
ブラウザーのコンソールに 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文字打ち間違えています。
// src/price.js
export function formatPrice(yen) {
return `${yen.toLocaleString('ja-JP')} 円`;
}
// 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 パネルに次のように出ました。
Uncaught SyntaxError: The requested module '/src/price.js' does not provide an export named 'formatPrise' (at main.js:1:10)

「読み込もうとしたモジュール /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 に直しました。
// 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' のままにすると、次のように出ました。
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 を読むときは、{ } を外します。
// 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' になりました。
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 と大文字を混ぜて書きました。
// src/main.js
import { nanoId } from 'nanoid';
document.getElementById('out').textContent = `ID: ${nanoId(8).length} 文字`;
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行でした。
export { customAlphabet, customRandom, nanoid, random, urlAlphabet };
import { nanoid } from 'nanoid' に直すと、エラーは消え、画面に「ID: 8 文字」と表示されました。
ビルドすると、ターミナルで止まる
開発サーバーではブラウザーのコンソールにしか出ませんが、ビルド(vite build)を実行すると、ターミナルでエラーになって止まります。打ち間違いのままの main.js でビルドすると、終了コード 1 で、次のように出ました(前後の行は省略しています)。
✗ 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 にすると、普通に起動したときも有効になります。
// vite.config.js
import { defineConfig } from 'vite';
export default defineConfig({
server: {
forwardConsole: true,
},
});
この設定で打ち間違いのページを開くと、ターミナルに次の行が出ました。
4:00:30 AM [vite] (client) [Unhandled error] SyntaxError: The requested module '/src/price.js' does not provide an export named 'formatPrise'
設定を変えずに使う場合は、ブラウザーのコンソールを開くか、ビルドを実行して確かめます。





