Cannot read properties of undefined (reading 'x')

Определение и применение

TypeError — у значения undefined или null нет свойств, а код обратился к одному из них. В скобках — имя свойства; значение слева от него и есть undefined. Для null сообщение то же, со словом null.

Объяснение на задачах — в уроке учебника «Безопасное обращение к свойствам».

Частые причины

  • Промежуточного объекта нет: order.delivery.price, а delivery не задан.
  • querySelector() не нашёл элемент и вернул null: неверный селектор или скрипт выполняется до разметки.
  • Данные ещё не загружены или сервер вернул другую структуру.
  • Индекс за пределами массива: list[5].title.
  • Функция ничего не вернула, а результат используется как объект.

Как исправить

Найдите в строке выражение слева от указанного свойства — оно равно undefined или null. Если отсутствие нормально, используйте опциональную цепочку order.delivery?.price ?? 0. Если значение обязано быть, исправьте его источник: селектор, порядок загрузки скрипта (defer), проверку ответа сервера.

Цепочка order.delivery?.price проверяет только delivery. Если может отсутствовать и order, нужна форма order?.delivery?.price. Оператор ?. не исправляет необъявленное имя и не должен скрывать обязательные данные.

Сообщения в браузерах

Примеры сообщений. Имена и подробности зависят от кода и версии браузера.

Cannot read properties of undefined (reading 'x') в разных браузерах
Браузер Сообщение
Chrome и Edge (V8) TypeError: Cannot read properties of undefined (reading 'price')
Firefox TypeError: can't access property "price", order.delivery is undefined
Safari (JavaScriptCore) TypeError: undefined is not an object (evaluating 'order.delivery.price')

В примерах ниже указан вывод Chromium.

Примеры

Нет промежуточного объекта

Вывод: TypeError: Cannot read properties of undefined (reading 'price'), затем 0 с опциональной цепочкой.

index.html
HTML
<!doctype html>
<html lang="ru">
<head>
  <meta charset="utf-8">
  <title>Нет промежуточного объекта</title>
</head>
<body>
  <script src="main.js"></script>
</body>
</html>
main.js
JavaScript
const order = { items: ["tea"] };
try {
  console.log(order.delivery.price);
} catch (error) {
  console.log(error.name + ": " + error.message);
}

console.log(order.delivery?.price ?? 0);

Спецификация

ECMAScript: Native Error Types.