ReferenceError: Cannot access 'x' before initialization

let / const / class を、宣言より前で使ったときに出ます。

console.log(value);

let value = 1;

let value = 1;

console.log(value);

直し方は単純です。宣言を、使うところより前に移します。

console.log(typeof later);

var later = 1;

console.log(typeof neverDeclared);

try {
  console.log(typeof later);
  let later = 1;
} catch (error) {
  console.log(error.name);
}

なぜ「宣言していない」ではないのか

エラー文が value is not defined ではないことに注目してください。 処理系は value の存在を知っています。 ただ、まだ使える状態になっていないだけです。

let と const は、ブロックの先頭から宣言の行までのあいだ、 一時的死角（TDZ）と呼ばれる状態に置かれます。 名前はあるのに触れない区間です。

var は違います。

hoisted();

function hoisted() {
  console.log('関数宣言は先に使える');
}

notYet();

const notYet = () => {};

var は宣言が先頭に巻き上げられ、値は undefined で始まります。 だからエラーにならずに undefined が出ます。

エラーになるほうが安全です。 var は間違いを黙って通します。

typeof でも避けられない

未宣言の変数なら typeof は安全ですが、一時的死角の中では違います。

new Thing();

class Thing {}

const name = '外側';

function show() {
  console.log(name);

  const name = '内側';
}

show();

typeof で存在を確かめる書き方は、ここでは効きません。

原因1: 関数宣言と関数式を混同している

const name = '外側';

function show() {
  console.log(name);

  const inner = '内側';

  console.log(inner);
}

show();

let n = 1;

{
  try {
    console.log(n);
    let n = 2;
  } catch (error) {
    console.log(error.name);
  }
}

console.log(n);

function で書いた関数は、丸ごと巻き上げられるので先に呼べます。 ところが const に入れた関数は呼べません。

try {
  eval('let dup = 1; let dup = 2;');
} catch (error) {
  console.log(error.name + ': ' + error.message);
}

同じ「関数」でも書き方で挙動が違います。 アロー関数や関数式を使うなら、定義を呼び出しより上に置いてください。

原因2: クラスを定義より前で使う

class も let と同じ扱いです。巻き上がりません。

原因3: 外側の同じ名前を隠している

これがいちばん見つけにくい形です。

console.log(name) は外側の name を見ていません。 関数の中に const name があるので、その関数の中では最初から内側の name です。 そしてその時点では、まだ触れません。

外側を使いたいなら、内側の宣言の名前を変えてください。

ブロックの中でも同じことが起きます。

似ているエラーとの違い

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

探しかたの順序

1. エラーの文に出ている名前を控える
2. その名前の宣言を、同じ関数・同じブロックの中で探す
3. 見つかったら、使っている行より下にないか見る
   • 下にある → 宣言を上へ移す
   • 外側の同名を使いたかった → 内側の名前を変える
4. 見つからなければ、var を let に変えた直後ではないか疑う

まとめ

• 宣言はある。まだ使える状態になっていない（一時的死角）
• var は undefined になるだけ。エラーになるほうが安全
• typeof でも避けられない
• 関数宣言は巻き上がるが、const に入れた関数は巻き上がらない
• class も巻き上がらない
• 外側の同名を隠している場合がいちばん見つけにくい

'use strict' を書くと何が変わるかは、文字列の第1回でも同じコードを両方のモードで実行して比べています。 → 文字列の基本