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

JavaScript / コードを試す

TypeError: Cannot read properties of undefined (reading 'x')

undefined のプロパティを読もうとしたときに出ます。原因を多い順に並べ、それぞれ直したコードを載せています。スタックトレースのどこを見るかも書いています。

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

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

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

コードを編集して試す

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

playground.js

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

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

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

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

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

undefined のプロパティを読もうとしたときに出ます。 x の部分には、読もうとしたプロパティ名が入ります。

javascript失敗・注意の例

const user = undefined;

console.log(user.name);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'name')
表示用コードUTF-8 · LF

user.name が undefined なのではありません。user そのものが undefined です。 ここを取り違えると、直す場所を間違えます。

まずスタックトレースを見る

text
TypeError: Cannot read properties of undefined (reading 'name')
    at showName (file:///app/example.mjs:7:15)
    at file:///app/example.mjs:10:13
    at ModuleJob.run (node:internal/modules/esm/module_job:343:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:681:26)
表示用コードUTF-8 · LF

見るのは上から2行目、つまり at で始まる最初の行です。 example.mjs の7行15文字目で起きた、と書いてあります。

行 見るか 何が書いてあるか
1行目 見る どのプロパティを読もうとしたか(reading 'name')
2行目 いちばん見る 自分のコードのどこで起きたか
3行目以降 見る そこを呼んだのは誰か(呼び出しの道すじ)
node:internal/ を含む行 無視してよい 処理系の内部。原因はここにない

node_modules/ や node:internal/ しか出ていないときは、 その1つ下の自分のコードの行まで下がって探します。

原因1: 探したものが見つからなかった(いちばん多い)

find() は見つからないと undefined を返します。例外は投げません。

javascript失敗・注意の例

const users = [{ id: 1, name: 'あかり' }];

const user = users.find(u => u.id === 2);

console.log(user.name);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'name')
表示用コードUTF-8 · LF

id: 2 の人はいないので user は undefined です。

直しかた

見つからなかったときにどうするかを、その場で決めます。

example.js

const users = [{ id: 1, name: 'あかり' }];

const user = users.find(u => u.id === 2);

if (!user) {
  console.log('該当する利用者がいません');
} else {
  console.log(user.name);
}
固定例の期待出力 · Node 24.22.3
該当する利用者がいません
表示用コードUTF-8 · LF

「あるなら読む、無いなら undefined でよい」ならオプショナルチェーンが短く書けます。

example.js

const users = [{ id: 1, name: 'あかり' }];

const user = users.find(u => u.id === 2);

console.log(user?.name);
console.log(user?.name ?? '(未登録)');
固定例の期待出力 · Node 24.22.3
undefined
(未登録)
表示用コードUTF-8 · LF

?. は左が null か undefined なら、そこで止まって undefined を返します。 何でも ?. を付ければよいわけではありません。 「無いことが正常」な場所にだけ使ってください。本来あるはずのものが無いなら、それは不具合です。

原因2: 途中の階層が無い

深いところを一気に辿ると、どこで切れたか分からなくなります。

javascript失敗・注意の例

const res = { data: {} };

console.log(res.data.user.name);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'name')
表示用コードUTF-8 · LF

res.data はあります。無いのは res.data.user です。 エラー文の reading 'name' は読もうとしたものなので、 その1つ手前が undefined だと分かります。

直しかた

example.js

const res = { data: {} };

console.log(res.data?.user?.name ?? '(なし)');
固定例の期待出力 · Node 24.22.3
(なし)
表示用コードUTF-8 · LF

どこで切れたかを調べたいときは、手前から順に出します。

example.js

const res = { data: {} };

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

原因3: 関数が何も返していない

return を書き忘れると、その関数は undefined を返します。エラーにはなりません。

javascript失敗・注意の例

function makeUser(name) {
  const user = { name };
}

const user = makeUser('あかり');

console.log(user.name);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'name')
表示用コードUTF-8 · LF

直しかた

example.js

function makeUser(name) {
  return { name };
}

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

アロー関数で {} を書いたときも同じです。n => { n * 2 } は undefined を返します。

原因4: 待つ前に触った

await を書き忘れると、まだ結果ではなく Promise が入っています。 Promise に name は無いので undefined になり、その先で落ちます。

javascript失敗・注意の例

async function fetchUser() {
  return { profile: { name: 'あかり' } };
}

const user = fetchUser();

console.log(user.profile.name);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of undefined (reading 'name')
表示用コードUTF-8 · LF

user は Promise です。user.profile が undefined になり、その .name で落ちます。

直しかた

example.js

async function fetchUser() {
  return { profile: { name: 'あかり' } };
}

const user = await fetchUser();

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

このページの実行環境では、コードの一番外側でも await が書けます。

似ているエラーとの違い

null のとき

null だと文言が変わります。別の原因なので読み分けてください。

javascript失敗・注意の例

const el = null;

console.log(el.value);
固定例の期待出力 · Node 24.22.3
TypeError: Cannot read properties of null (reading 'value')
表示用コードUTF-8 · LF

null は「無いことが分かっている」印です。ブラウザで document.querySelector() が見つけられなかったときは null が返ります。

文言 中身 典型的な原因
... of undefined まだ入っていない / 返ってこなかった find() が空振り、return 忘れ、await 忘れ
... of null 無いと分かっている querySelector() が見つけられなかった

関数ではないとき

プロパティは読めたが、それが関数ではなかった場合は別のエラーです。

javascript失敗・注意の例

const user = { name: 'あかり' };

console.log(user.getName());
固定例の期待出力 · Node 24.22.3
TypeError: user.getName is not a function
表示用コードUTF-8 · LF

こちらは TypeError: x is not a function にまとめてあります。

処理系によって文言が違う

同じ原因でも、書いてある文が違います。検索するときは自分の環境の文言で調べてください。

処理系 文言
Node / Chrome(V8) Cannot read properties of undefined (reading 'name')
Chrome(古い版) Cannot read property 'name' of undefined
Firefox(SpiderMonkey) user is undefined
Safari(JavaScriptCore) undefined is not an object (evaluating 'user.name')

実行結果は、記事冒頭に示したNodeの版で確認しています。

起きにくくするには

  • 見つからないことがある関数を覚える。 find() / at() / pop() / Map.get() / querySelector() は、空振りすると undefined か null を返します
  • 一気に辿らない。 a.b.c.d と書く前に、a.b が何かを確かめる
  • ?. を保険として撒かない。 無いことが正常な場所にだけ使う。 そうしないと不具合が静かに先へ進みます

配列から目的の要素を取り出すときの find() と filter() の違いは filter() にまとめてあります。

出典

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