できない.dev

Node.js「Error [ERR_REQUIRE_ESM]」の原因と直し方

Error [ERR_REQUIRE_ESM] は、動的 import() で読むか type:module に切り替えれば直る。
ESM 専用パッケージを CommonJS の require() で読むと出る。

公開: 更新:

症状できない · exit 1
node --no-experimental-require-module use-require.js
…
Error [ERR_REQUIRE_ESM]: require() of ES Module /tmp/tmp.l6pV3P4Tnv/esm-pkg/index.js from /tmp/tmp.l6pV3P4Tnv/use-require.js not supported.
Instead change the require of index.js in /tmp/tmp.l6pV3P4Tnv/use-require.js to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/tmp/tmp.l6pV3P4Tnv/use-require.js:1:13) {
  code: 'ERR_REQUIRE_ESM'
解決後できた · exit 0
node use-import.js
動的 import の結果: hello from esm

2026-08-02 に node:20 で実際に打って取った出力。検証環境の詳細

要約

Error [ERR_REQUIRE_ESM]: require() of ES Module ... not supported. は、require() で ESM 専用のパッケージを読もうとして拒否されたときに出るエラーである。
まず Node のバージョンを確かめる。
require(esm) は Node 20.19 / 22.12 以降では既定で有効で、ESM を require() してもこのエラーは出ない。
それでも出るなら、Node がこれより古いか、対象の ESM が top-level await を含んでいる(その場合は別エラー ERR_REQUIRE_ASYNC_MODULE になる)。
確実に直せるのは動的 import() で、ほかに type:module 化・バージョン pin・Node の更新がある。

実行例

Node.js v20.20.2(Debian GNU/Linux 12 bookworm)環境で上記の手順を実行すると、素の require() は終了コード 0 で通った。
--no-experimental-require-module を付けると、ERR_REQUIRE_ESM(終了コード 1)が再現した。
top-level await を含む ESM では、新しい Node でも ERR_REQUIRE_ASYNC_MODULE(終了コード 1)が発生した。

$ node --version
v20.20.2
$ node use-require.js
[Module: null prototype] {
  __esModule: true,
  default: 'hello from esm'
}
$ echo $?
0
$ node --no-experimental-require-module use-require.js
/tmp/tmp.l6pV3P4Tnv/use-require.js:1
const pkg = require("esm-pkg");
            ^
 
Error [ERR_REQUIRE_ESM]: require() of ES Module /tmp/tmp.l6pV3P4Tnv/esm-pkg/index.js from /tmp/tmp.l6pV3P4Tnv/use-require.js not supported.
Instead change the require of index.js in /tmp/tmp.l6pV3P4Tnv/use-require.js to a dynamic import() which is available in all CommonJS modules.
    at Object.<anonymous> (/tmp/tmp.l6pV3P4Tnv/use-require.js:1:13) {
  code: 'ERR_REQUIRE_ESM'
}
 
Node.js v20.20.2
$ echo $?
1
$ node use-require-tla.js
node:internal/modules/esm/module_job:433
      throw new ERR_REQUIRE_ASYNC_MODULE(filename, parentFilename);
      ^
 
Error [ERR_REQUIRE_ASYNC_MODULE]: require() cannot be used on an ESM graph with top-level await. Use import() instead. To see where the top-level await comes from, use --experimental-print-required-tla.
  From /tmp/tmp.l6pV3P4Tnv/use-require-tla.js 
  Requiring /tmp/tmp.l6pV3P4Tnv/esm-tla.mjs 
    at ModuleJobSync.runSync (node:internal/modules/esm/module_job:433:13)
    at ModuleLoader.importSyncForRequire (node:internal/modules/esm/loader:389:47)
    at loadESMFromCJS (node:internal/modules/cjs/loader:1363:24)
    at Module._compile (node:internal/modules/cjs/loader:1503:5)
    at Module._extensions..js (node:internal/modules/cjs/loader:1623:10)
    at Module.load (node:internal/modules/cjs/loader:1266:32)
    at Module._load (node:internal/modules/cjs/loader:1091:12)
    at Module.require (node:internal/modules/cjs/loader:1289:19)
    at require (node:internal/modules/helpers:182:18)
    at Object.<anonymous> (/tmp/tmp.l6pV3P4Tnv/use-require-tla.js:1:13) {
  code: 'ERR_REQUIRE_ASYNC_MODULE'
}
 
Node.js v20.20.2
$ echo $?
1
$ node use-import.js
動的 import の結果: hello from esm
$ echo $?
0

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
node:20

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 動的 import を await する

// CJS プロジェクトのまま、関数内で取り込む
async function main() {
  const { default: chalk } = await import("chalk");
  console.log(chalk.green("ok"));
}
main();

CJS のトップレベルでは await が使えないため関数で囲む。
公式 ESM ドキュメント(新しいタブで開く) のとおり、動的 import() は ESM / CJS どちらからも呼べる唯一の橋渡しである。

2. プロジェクトを ESM 化

package.json に追記する。

{
  "type": "module"
}

これで .js が ESM 扱いになり、import { x } from "pkg" がそのまま使える。
require を残したいファイルだけ拡張子を .cjs に変える。

3. CJS 対応の最終版に pin

npm install chalk@^4

移行が間に合わない既存コードは、暫定策として ESM 化前の最終メジャーに固定する。
^5 などに上げ直す前に、テストが通る状態を作る。

4. Node を 20.19 / 22.12 以降に上げる(require(esm) が既定で有効)

require(esm)(CJS から ESM を require() する機能)は Node 22.12.0 で unflag され、20.19.0 にもバックポートされた。
現在は stable で、フラグ不要・既定で有効になっている。
これらの版に上げれば、ESM only パッケージも require() でそのまま読める(Node.js Modules ドキュメント(新しいタブで開く))。

ただし、対象の ESM(または依存)が top-level await を含む場合は、新しい Node でも require() できず ERR_REQUIRE_ASYNC_MODULE になる。
このケースは Node を上げても直らないので、解決策 1 の動的 import() を使う。
逆に旧来どおりの挙動に戻したい CI などでは、--no-experimental-require-module を付けると require(esm) を無効化できる。

よくある原因

  1. 依存パッケージが ESM only に更新された。
    chalk@5 / node-fetch@3 / nanoid@4 のように、メジャー更新で ESM only に切り替えたパッケージを CJS から require している。
  2. モジュール構文が混在している。
    CJS 前提のプロジェクトで import 構文を混ぜているが、tsc / Babel の出力は require のままになっている。
  3. package.json で type を指定していない。
    "type":"module" が無いと、Node は .js を CJS として扱う。
  4. Node が 20.19 / 22.12 より古い。
    これらの版より前は require(esm) が既定で無効なため、ESM only を require した瞬間に ERR_REQUIRE_ESM になる。
    20.19 / 22.12 以降は既定で require できるが、対象 ESM が top-level await を含むと別エラー ERR_REQUIRE_ASYNC_MODULE に変わる。