Node.jsの__dirname is not definedの直し方
ターミナルで ReferenceError: __dirname is not defined in ES module scope が出るのは、ES モジュールとして読まれたファイルの中で __dirname を使ったときです。__dirname は CommonJS(require を使う、Node.js に元からある形式)のファイルでしか使えません。ES モジュールでは import.meta.dirname に書き換えると、エラーが消えます。
package.json に "type": "module" を書いて import を使えるようにしたあと、スクリプトと同じフォルダーにある設定ファイルやテンプレートを path.join(__dirname, ...) で読もうとしたときに出ます。私は検証環境でエラーを起こし、メッセージの全文と、直すと消えることを確かめました。
検証環境は Ubuntu 24.04 です。主に Node.js 24.22.1(npm 11.19.1)で試し、比べるために Node.js 22.23.4 と 20.10.0 でも同じファイルを実行しました。Node.js 20.10.0 は、nodejs.org で配布されている Linux 用のバイナリを使いました。Windows と macOS、TypeScript のファイル(.ts)を直接実行する場合、webpack や Jest などのツールの中で出る同じ名前のエラーは試していません。
エラーの全文
検証環境(Ubuntu 24.04、Node.js 24.22.1)で npm init -y を実行し、npm pkg set type=module で package.json の "type" を "module" にしました。同じフォルダーに、「hello」とだけ書いた message.txt と、次の index.js を置きました。スクリプトの置き場所を基準に message.txt を読み、中身を表示するだけのコードです。
import { readFileSync } from 'node:fs';
import path from 'node:path';
const file = path.join(__dirname, 'message.txt');
console.log(readFileSync(file, 'utf8').trim());
node index.js を実行すると、次のように出て止まりました(終了コードは1。パスは例示用の値に置き換えています)。
$ node index.js
file:///path/to/app/index.js:4
const file = path.join(__dirname, 'message.txt');
^
ReferenceError: __dirname is not defined in ES module scope
This file is being treated as an ES module because it has a '.js' file extension and '/path/to/app/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.
at file:///path/to/app/index.js:4:24
at ModuleJob.run (node:internal/modules/esm/module_job:561:25)
at async node:internal/modules/esm/loader:647:26
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)
Node.js v24.22.1
エラー本体は ReferenceError: __dirname is not defined in ES module scope の行で、「ES モジュールの中では __dirname は定義されていない」という意味です。いちばん上の file:///path/to/app/index.js:4 と ^ が、何行目のどこで止まったかを示しています。
その下の英文は、このファイルが ES モジュールとして扱われた理由です。「拡張子が .js で、package.json に "type": "module" があるので ES モジュールとして扱った。CommonJS として扱うなら、拡張子を .cjs にしてください」と書かれています。
拡張子が .mjs のファイルは、package.json の type に関係なく ES モジュールとして読まれます。package.json を "type": "commonjs" にして、同じ中身の index.mjs を実行すると、同じ ReferenceError が出ました。この場合は理由の英文が付かず、ReferenceError の行のすぐ下にスタックが続きます。
__filename を使った場合も同じ形で、ReferenceError: __filename is not defined in ES module scope と出ました。公式ドキュメントの、ES モジュールと CommonJS の違いの説明にも、__filename と __dirname は ES モジュールでは使えず、代わりに import.meta.filename と import.meta.dirname を使うと書かれています。
import.meta.dirname に書き換える
Node.js 20.11.0 以降(21 系では 21.2.0 以降)なら、__dirname を import.meta.dirname に、__filename を import.meta.filename に置き換えるだけで済みます。値を確かめるために、2つを表示する行も足しました。
import { readFileSync } from 'node:fs';
import path from 'node:path';
console.log(import.meta.dirname);
console.log(import.meta.filename);
const file = path.join(import.meta.dirname, 'message.txt');
console.log(readFileSync(file, 'utf8').trim());
$ node fixed-meta.js
/path/to/app
/path/to/app/fixed-meta.js
hello
エラーは出ず、import.meta.dirname にはファイルのあるフォルダー、import.meta.filename にはファイルの絶対パスが入っていました。ルート(/)に移ってから node /path/to/app/fixed-meta.js と実行しても、表示は同じでした。__dirname と同じく、実行したときのフォルダーではなく、スクリプトの置き場所が基準になります。Node.js 22.23.4 でも同じ結果でした。
公式ドキュメントの import.meta.dirname の説明によると、この2つは Node.js 21.2.0 と 20.11.0 で追加され、Node.js 24.0.0 で実験的な扱いではなくなりました。また、手元のファイルから file: で読み込まれたモジュールでしか使えません。
この2つが追加される前の Node.js(20.10.0 で試しました)では、import.meta.dirname や import.meta.filename を書いてもエラーにならず、値が undefined になります。上の fixed-meta.js を Node.js 20.10.0 で実行すると、undefined が2行表示されたあと、path.join で TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string. Received undefined が出て止まりました。古い Node.js でも動かす必要があるなら、次の節の書き方を使います。
古い Node.js でも動く、import.meta.url から作る書き方
import.meta.dirname が使えない Node.js でも、import.meta.url(ファイルの場所を表す file:///... の URL)は使えます。この URL を fileURLToPath でパスに直し、path.dirname でフォルダーを取り出すと、__dirname と同じ値になります。ファイルの先頭で同じ名前の変数を作っておけば、その下のコードは書き換えずに済みます。
import { readFileSync } from 'node:fs';
import path from 'node:path';
import { fileURLToPath } from 'node:url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
console.log(import.meta.url);
const file = path.join(__dirname, 'message.txt');
console.log(readFileSync(file, 'utf8').trim());
$ node fixed-url.js
file:///path/to/app/fixed-url.js
hello
Node.js 24.22.1 でも 20.10.0 でも、同じ表示になりました。
ファイルを読むだけなら new URL で直接指定できる
__dirname を使う目的が「スクリプトの横にあるファイルを読む」ことだけなら、フォルダーのパスを作らなくても済みます。new URL('./message.txt', import.meta.url) で、スクリプトの場所から見た message.txt の URL ができます。node:fs の関数の多くは、パスの文字列の代わりに file: の URL オブジェクトを受け取れます(公式ドキュメントの、ファイルの URL をパスとして渡す説明)。
import { readFileSync } from 'node:fs';
const file = new URL('./message.txt', import.meta.url);
console.log(readFileSync(file, 'utf8').trim());
このファイルを実行すると、エラーは出ずに hello と表示されました。
CommonJS のまま使いたいときは拡張子を .cjs にする
import を使う必要がないファイルなら、エラーの英文が勧めているとおり、拡張子を .cjs にして require で書く方法もあります。.cjs のファイルは、package.json が "type": "module" でも CommonJS として読まれるので、__dirname がそのまま使えます。
const { readFileSync } = require('node:fs');
const path = require('node:path');
const file = path.join(__dirname, 'message.txt');
console.log(readFileSync(file, 'utf8').trim());
"type": "module" のまま、この index.cjs を実行すると、エラーは出ずに hello と表示されました。逆に、.cjs のファイルに import 文を書いて実行すると、SyntaxError: Cannot use import statement outside a module で止まりました。拡張子を変えるなら、ファイル全体を require の書き方にそろえます。拡張子と package.json の type でファイルの形式が決まる仕組みは、公式ドキュメントにある、モジュールの形式の決め方の説明にまとまっています。





