できない.dev

ECMAScript Modules

別名: ESM / ES Modules / ESモジュール

JavaScript の標準モジュール方式。
import / export で依存を静的に宣言し、ブラウザと Node.js の両方で動く。
CommonJS の require とは解決規則も実行タイミングも異なる。

公開: 更新:

定義

ECMAScript Modules(ESM) は、ECMAScript 仕様で標準化された JavaScript のモジュールシステムである。
import / export 構文で依存関係を静的に宣言し、モダンブラウザと Node.js のどちらでも動作する。
Node.js が従来使ってきた CommonJS(require / module.exports)とは別の系統に属する。

詳細

ESM はファイルを「モジュール」として扱い、トップレベルの import を解決してから本体を実行する。
Node.js では package.json の "type": "module" か拡張子 .mjs で ESM 扱いになる。
相対 import は拡張子まで明示が必要で、トップレベル await が使える。
多くのライブラリがメジャー更新で ESM 専用へ移行している。

よくある誤解

  • CommonJS と自由には混ぜられない。
    ESM から CommonJS は import できるが、CommonJS から ESM は require() できず ERR_REQUIRE_ESM になる(動的 import() だけが橋渡し)。
  • 拡張子は省略できない。
    ESM の相対 import では、拡張子の省略が認められていない。

関連

モジュールが見つからない失敗は Cannot find module として表面化する。
対になる方式が CommonJS で、型解決側は TypeScript の moduleResolution が担う。