ReferenceError: x is not defined

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

console.log(notDeclared);

const userName = 'あ';

console.log(userName);

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

console.log(typeof notDeclared);

if (typeof someGlobal === 'undefined') {
  console.log('この環境には無い');
}

似ているエラーとの違い

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

x is not defined だけが「名前そのものが見つからない」です。

typeof なら落ちない

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

setUp();

console.log(config);

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

const config = setUp();

console.log(config);

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

if (true) {
  const inside = 1;
}

console.log(inside);

console.log(typeof window);
console.log(typeof document);
console.log(typeof globalThis);

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

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

useHelper();

// helper.js は、このあとで読み込まれる

'use strict';

try {
  undeclared = 1;
} catch (error) {
  console.log(error.name + ': ' + error.message);
}

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

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

undeclared = 1;

console.log(undeclared);
console.log(globalThis.undeclared);

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

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

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

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

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

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

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

原因3: 読み込み順

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

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

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

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

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

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

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

探しかたの順序

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

このページの実行結果は Node 22.22.3 のものです。文言は処理系と版によって変わります。自分の環境で出た文言で検索してください。

まとめ

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

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