TypeError: undefined のプロパティ参照

解説

このレッスンで分かること

• この記事では「TypeError: undefined のプロパティ参照」を デバッグ基礎 の現場で使える形で整理します
• TypeError とは をおさえれば、現場で迷ったときに立ち戻れる
• よくある原因 をおさえれば、現場で迷ったときに立ち戻れる
• エラーメッセージの読み方 をおさえれば、現場で迷ったときに立ち戻れる
• 解決のコツ をおさえれば、現場で迷ったときに立ち戻れる

解説

TypeError とは

undefined や null のプロパティにアクセスしようとしたエラーを修正します。本レッスンでは、TypeError の基本から実際の使いどころまでを整理し、現場で迷わず使える形に落とし込みます。

TypeError とは

TypeError は、値の 型 が期待と異なるときに発生します。 最も多いのは undefined や null のプロパティにアクセスしようとしたケースです。

解説

「Cannot read properties of undefined」が出たら、ドットの左側の変数が undefined。a.b.c でエラーなら、a.b が undefined だったということです。

よくある原因

1. 存在しないプロパティ — オブジェクトに存在しないキーを参照
2. null/undefined チェック漏れ — 値が存在するか確認せずにアクセス
3. 非同期処理 — データ取得前にアクセス

エラーメッセージの読み方

「undefined のプロパティ 'name' を読めない」= .name の前の値が undefined

解説

エラー文の reading 'xxx' がヒント。xxx の左の値が undefined だと特定できるので、そこから上流に遡って「なぜ undefined になったか」を追えば原因にたどり着きます。

解決のコツ

1. エラーの行でどの値が undefined か特定
2. その値がなぜ undefined なのか遡って調査
3. オプショナルチェイニング ?. や if チェックで防御

現場でよくある具体例

1. 現場ケース 1 — 「本番だけ落ちる」謎エラーが、環境変数の NODE_ENV 違いで設定ファイルを切り替えていなかったことが原因。二分探索でコミットを絞り 30 分で解決
2. 現場ケース 2 — フロントの無限ローディングは、useEffect 依存配列に毎レンダー新しい関数を渡していた。React DevTools のレンダー回数で気づけた
3. 現場ケース 3 — DB の遅いクエリは EXPLAIN でフルスキャン発覚。複合インデックス追加で 300 倍速く。「測ってから直す」の典型例

次にとるべきアクション

1. 直近 1 週間で詰まったエラーを 1 つ思い出す — そのエラーに「TypeError: undefined のプロパティ参照」で学んだアプローチを適用してみる
2. デバッグメモのテンプレを自分用に作る — 現象・再現手順・仮説・検証結果の 4 項目を markdown で固定化する
3. console.log だけで解いていた問題に DevTools のブレークポイントを使う — ステップ実行を 1 回でも体験する

次のレッスン

次は TypeError: is not a function で、undefined や null のプロパティにアクセスしようとしたエラーを修正します を学びます。

事前確認 — 進む前に次の 3 つができることを確認しましょう。

1. 型：プロパティ参照 の要点を自分の言葉で説明できる
2. このレッスンの最小コード (または操作手順) を見ずに書ける
3. 練習問題やクイズで間違えた箇所を読み直して理解した

理解度チェック (30 秒)

Q. 型：プロパティ参照 とは何か、1 文で説明してください。

関連レッスン

• TypeError: null参照エラー
• mapのreturn忘れ
• await 忘れ

参考にした出典

• MDN Web Docs「Debugging JavaScript」 — ブラウザ DevTools を使ったデバッグ手順（出典: Mozilla, https://developer.mozilla.org/ja/docs/Tools/Debugger）
• Google Chrome DevTools 公式ドキュメント — ブレークポイント・パフォーマンスタブ等の正式仕様（出典: Google, https://developer.chrome.com/docs/devtools/）
• IEEE Software「Why Programs Fail」 — 不具合発見と修正プロセスに関する古典研究（出典: Andreas Zeller, Morgan Kaufmann, 2009, https://ieeexplore.ieee.org/）

解説

学習を加速したい方へ

デバッグの基礎ガイドを体系的にマスターするなら、chotdekiru の無料学習ポータル で実際に手を動かして学習を始めるのがおすすめです。質問・つまずきも現役エンジニアが伴走します。