できない.dev

__dirname

別名: __filename / __dirname is not defined

__dirname は、Node.js の CommonJS モジュールで実行中のファイルがあるディレクトリの絶対パスを持つ値である。
ES モジュールには無く、import.meta.dirname で代わりに求める。

公開:

定義

__dirname は、Node.js の CommonJS モジュールの中で、実行中のファイルがあるディレクトリの絶対パスを持つ文字列である。
対になる __filename はファイル自身の絶対パスを持ち、シンボリックリンクを解決した後の値になる。
__dirname は path.dirname(__filename) と同じ値を返す。

詳細

Node.js は CommonJS のファイルを実行する前に、コード全体を exports・require・module・__filename・__dirname を引数に取る関数で包む。
このため __dirname はグローバル変数として存在するわけではなく、モジュールごとに渡される局所的な値である。

path.join(__dirname, "public") と書くと、node をどのディレクトリから起動しても同じ場所を指せる。
Express の express.static や Vite の resolve.alias で絶対パスを作るときによく使われる。

よくある誤解

  • ES モジュールでも使えると思われがちだが、Node.js の公式ドキュメントは ES モジュールでは使えないと明記している。
    代わりに Node.js 20.11.0・21.2.0 以降の import.meta.dirname を使うか、import.meta.url から fileURLToPath で求める。
  • process.cwd() と同じ値を返すとは限らない。
    process.cwd() は起動したときの作業ディレクトリを返すので、別の場所から起動すると __dirname とずれる。
  • TypeScript の Cannot find name '__dirname' は、型定義の @types/node が読まれていないときに型検査の段階で出る。

関連

ES モジュールでの書き換えは Node.js「__dirname is not defined」が ESM で出る原因と直し方 にまとめている。
代わりに使う値は import.meta、モジュール方式の違いは CommonJS で説明している。