できない.dev

ReferenceError

別名: is not defined

ReferenceError は、存在しない(まだ初期化されていない)変数を参照したときに JavaScript が投げる例外。
多くは 'x is not defined' というメッセージで現れる。

公開: 更新:

定義

ReferenceError は、存在しない変数や、まだ初期化されていない変数を参照したときに JavaScript が投げる例外である。
x is not defined という形のメッセージで現れる。
名前の打ち間違いだけでなく、その実行環境にそもそも無いグローバルを使ったときにも発生する。

詳細

ブラウザにあって Node.js に無い window や document、ESM に無い __dirname や require、ビルド前に置換される process.env などは、実行環境が変わると未定義になる。
let / const の宣言前にアクセスする一時的デッドゾーン(TDZ)でも、ReferenceError が出る。

よくある誤解

ReferenceError は TypeError とは異なる。
TypeError は「変数は存在するが型や操作が不正」なときに出て、ReferenceError は「名前そのものが解決できない」ときに出る。
値として undefined が入っている状態とも別で、その場合は参照自体は成功している。

関連

ESM で __dirname が使えない、Vite で process が未定義、SSR で window is not defined は、いずれも実行環境にそのグローバルが無いことから起きる。