JavaScript / コードを試す
ReferenceError: x is not defined
宣言していない名前を読もうとしたときに出ます。綴り違い、読み込み順、スコープの外、 Node とブラウザで存在しないもの。原因を多い順に並べ、それぞれ直したコードを載せています。
固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。
同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。
コードを編集して試す
ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。
8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。
パネルを開くと編集できます。
現在の入力は未実行です。
入力中のコードをこの例へ置き換えます。
実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。
どこにも宣言が無い名前を読もうとしたときに出ます。
console.log(notDeclared);ReferenceError: notDeclared is not defined
まず綴りを確かめてください。 大文字小文字も区別されます。
const userName = 'あ'; console.log(userName);
あ
似ているエラーとの違い
ここを取り違えると、探す場所を間違えます。
| 文言 | 意味 | 探す場所 |
|---|---|---|
x is not defined |
宣言が無い | 綴り・読み込み・スコープ |
Cannot access 'x' before initialization |
宣言はある。まだ使えない | 宣言の位置 |
Cannot read properties of undefined |
変数はある。中身が undefined |
値の出どころ |
x is not a function |
変数はある。関数ではない | 呼び出し |
x is not defined だけが「名前そのものが見つからない」です。
typeof なら落ちない
console.log(typeof notDeclared);
undefined
typeof は、宣言が無くても例外にならない数少ない書き方です。
あるかどうかを調べたいときに使えます。
if (typeof someGlobal === 'undefined') { console.log('この環境には無い'); }
この環境には無い
ただし let / const の宣言より前では、typeof でも落ちます。
そちらは別のエラーです。
→ Cannot access before initialization
原因1: スコープの外から読んでいる
function setUp() {
const config = { retry: 1 };
}
setUp();
console.log(config);ReferenceError: config is not defined
config は関数の中だけの名前です。外からは見えません。
外で使いたいなら、返して受け取ります。
function setUp() { return { retry: 1 }; } const config = setUp(); console.log(config);
{ retry: 1 }{} のブロックでも同じです。
if (true) {
const inside = 1;
}
console.log(inside);ReferenceError: inside is not defined
let と const はブロックの中だけで生きています。
原因2: 環境に無いものを使っている
同じコードでも、動く場所によって存在しないものがあります。
console.log(typeof window); console.log(typeof document); console.log(typeof globalThis);
undefined undefined object
上はこのページの実行環境(ブラウザのワーカー)での結果です。画面を持たないので window も document もありません。
| 名前 | ブラウザの画面 | Node | ワーカー |
|---|---|---|---|
window document |
ある | 無い | 無い |
require |
無い | CommonJS のときだけ | 無い |
process |
無い | ある | 無い |
globalThis |
ある | ある | ある |
どこでも使えるのは globalThis だけです。
require is not defined が出たときは、そのファイルが
モジュールとして読まれている(import を使う)ことを疑ってください。
原因3: 読み込み順
<script> を並べる書き方では、後ろのファイルの中身は前のファイルから見えません。
useHelper();
// helper.js は、このあとで読み込まれるimport で書けば、順番は処理系が解決します。
古い書き方のまま並べているなら、使う側を後ろに置いてください。
原因4: 代入したつもりで宣言していない
'use strict'; try { undeclared = 1; } catch (error) { console.log(error.name + ': ' + error.message); }
ReferenceError: undeclared is not defined
宣言せずに代入すると、strict モードでは代入の時点で落ちます。
strict でないと、代入は通ってしまいます。 そしてグローバルに名前が増えます。
undeclared = 1; console.log(undeclared); console.log(globalThis.undeclared);
1 1
気づかないうちにグローバルを汚しています。
import / export のあるファイルは自動的に strict なので、実務では落ちるほうが普通です。
必ず const か let を書いてください。
探しかたの順序
- エラーの文に出ている名前をそのまま検索する。宣言が1つも無ければ綴り違い
- 宣言があるなら、それが同じスコープにあるか見る
- 関数やブロックの中なら → 返して受け取る
windowdocumentrequireprocessのどれかなら → 環境の違い- どれでもなければ、宣言より前で使っていないか見る
- その場合、文言は
Cannot access ... before initializationになっているはず
- その場合、文言は
実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。自分の環境で出た文言で検索してください。
まとめ
- 名前そのものが見つからないとき。まず綴りを疑う
typeofなら宣言が無くても落ちない。存在確認に使えるlet/constはブロックの中だけ。外からは見えないwindowdocumentrequireprocessは環境によって無い- 宣言せずに代入すると、strict では落ち、そうでないと黙ってグローバルが増える
変数はあるのに中身が undefined だった、という場合はこちらです。
→ Cannot read properties of undefined