本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

ReferenceError: x is not defined

宣言していない名前を読もうとしたときに出ます。綴り違い、読み込み順、スコープの外、 Node とブラウザで存在しないもの。原因を多い順に並べ、それぞれ直したコードを載せています。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

どこにも宣言が無い名前を読もうとしたときに出ます。

javascript失敗・注意の例

console.log(notDeclared);
固定例の期待出力 · Node 24.22.3
ReferenceError: notDeclared is not defined
表示用コードUTF-8 · LF

まず綴りを確かめてください。 大文字小文字も区別されます。

example.js

const userName = 'あ';

console.log(userName);
固定例の期待出力 · Node 24.22.3
あ
表示用コードUTF-8 · LF

似ているエラーとの違い

ここを取り違えると、探す場所を間違えます。

文言 意味 探す場所
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 なら落ちない

example.js

console.log(typeof notDeclared);
固定例の期待出力 · Node 24.22.3
undefined
表示用コードUTF-8 · LF

typeof は、宣言が無くても例外にならない数少ない書き方です。 あるかどうかを調べたいときに使えます。

example.js

if (typeof someGlobal === 'undefined') {
  console.log('この環境には無い');
}
固定例の期待出力 · Node 24.22.3
この環境には無い
表示用コードUTF-8 · LF

ただし let / const の宣言より前では、typeof でも落ちます。 そちらは別のエラーです。 → Cannot access before initialization

原因1: スコープの外から読んでいる

javascript失敗・注意の例

function setUp() {
  const config = { retry: 1 };
}

setUp();

console.log(config);
固定例の期待出力 · Node 24.22.3
ReferenceError: config is not defined
表示用コードUTF-8 · LF

config は関数の中だけの名前です。外からは見えません。

外で使いたいなら、返して受け取ります。

example.js

function setUp() {
  return { retry: 1 };
}

const config = setUp();

console.log(config);
固定例の期待出力 · Node 24.22.3
{ retry: 1 }
表示用コードUTF-8 · LF

{} のブロックでも同じです。

javascript失敗・注意の例

if (true) {
  const inside = 1;
}

console.log(inside);
固定例の期待出力 · Node 24.22.3
ReferenceError: inside is not defined
表示用コードUTF-8 · LF

let と const はブロックの中だけで生きています。

原因2: 環境に無いものを使っている

同じコードでも、動く場所によって存在しないものがあります。

example.js

console.log(typeof window);
console.log(typeof document);
console.log(typeof globalThis);
固定例の期待出力 · Node 24.22.3
undefined
undefined
object
表示用コードUTF-8 · LF

上はこのページの実行環境(ブラウザのワーカー)での結果です。画面を持たないので window も document もありません。

名前 ブラウザの画面 Node ワーカー
window document ある 無い 無い
require 無い CommonJS のときだけ 無い
process 無い ある 無い
globalThis ある ある ある

どこでも使えるのは globalThis だけです。

require is not defined が出たときは、そのファイルが モジュールとして読まれている(import を使う)ことを疑ってください。

原因3: 読み込み順

<script> を並べる書き方では、後ろのファイルの中身は前のファイルから見えません。

javascript失敗・注意の例
useHelper();

// helper.js は、このあとで読み込まれる
表示用コードUTF-8 · LF

import で書けば、順番は処理系が解決します。 古い書き方のまま並べているなら、使う側を後ろに置いてください。

原因4: 代入したつもりで宣言していない

example.js

'use strict';

try {
  undeclared = 1;
} catch (error) {
  console.log(error.name + ': ' + error.message);
}
固定例の期待出力 · Node 24.22.3
ReferenceError: undeclared is not defined
表示用コードUTF-8 · LF

宣言せずに代入すると、strict モードでは代入の時点で落ちます。

strict でないと、代入は通ってしまいます。 そしてグローバルに名前が増えます。

example.js

undeclared = 1;

console.log(undeclared);
console.log(globalThis.undeclared);
固定例の期待出力 · Node 24.22.3
1
1
表示用コードUTF-8 · LF

気づかないうちにグローバルを汚しています。 import / export のあるファイルは自動的に strict なので、実務では落ちるほうが普通です。

必ず const か let を書いてください。

探しかたの順序

  1. エラーの文に出ている名前をそのまま検索する。宣言が1つも無ければ綴り違い
  2. 宣言があるなら、それが同じスコープにあるか見る
    • 関数やブロックの中なら → 返して受け取る
  3. window document require process のどれかなら → 環境の違い
  4. どれでもなければ、宣言より前で使っていないか見る
    • その場合、文言は Cannot access ... before initialization になっているはず

実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。自分の環境で出た文言で検索してください。

まとめ

  • 名前そのものが見つからないとき。まず綴りを疑う
  • typeof なら宣言が無くても落ちない。存在確認に使える
  • let / const はブロックの中だけ。外からは見えない
  • window document require process は環境によって無い
  • 宣言せずに代入すると、strict では落ち、そうでないと黙ってグローバルが増える

変数はあるのに中身が undefined だった、という場合はこちらです。 → Cannot read properties of undefined

出典

この教材の原文(Markdown・別タブ)