Опциональная цепочка ?.

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

Опциональная цепочка ?. обращается к свойству или вызывает функцию, только если значение слева не null и не undefined. Иначе непрерывная цепочка возвращает undefined без ошибки.

Различие отсутствующих значений разобрано в уроке «null и undefined».

Поддержка браузерами

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

Поддерживается во всех основных браузерах с 2020 года.

Показать браузеры
Совместимостьjavascript.operators.optional_chaining
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
Optional chaining operator (?.)✓80✓80✓74✓67✓13.1✓80✓79✓57✓13.4✓13.0✓80✓13.4

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

Синтаксис

JavaScript
объект?.ключ
объект?.[выражение]
функция?.(аргументы)

объект и функция — проверяемые значения. ключ — буквальное имя свойства, выражение вычисляет ключ, аргументы передаются при состоявшемся вызове.

Особенности применения

Срабатывает короткое замыкание: если a — undefined, в a?.b.c.d() не вычисляется ничего правее, включая вызов.

Запасное значение добавляют через ??: order?.delivery?.price ?? 0.

?. нельзя использовать слева от присваивания (a?.b = 1), как цепочку конструктора (new a?.Ctor()) или непосредственно перед теговым шаблоном. Это SyntaxError. Запись new (a?.Ctor)() синтаксически допустима, но всё равно требует конструктора в результате.

Не ставьте ?. везде «на всякий случай»: если значение обязано быть, ошибка лучше, чем тихий undefined дальше по программе. ?. уместен там, где отсутствие — нормальная ситуация.

Скобки разрывают защиту: (a?.b).c при a === null бросает TypeError. Необъявленное имя слева по-прежнему даёт ReferenceError. Вызов obj.method?.() не защищает от существующего свойства, которое не является функцией.

Проверьте это поведение в примере «Граница непрерывной цепочки».

Основной результат можно проверить и изменить в запускаемом примере.

Примеры

Безопасный доступ и вызов

Вывод: undefined, 0, undefined, Мёд. Добавьте delivery: { price: 200 } в order: запасной ноль не понадобится.

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: [{ title: "Мёд" }] };
console.log(order.delivery?.price);
console.log(order.delivery?.price ?? 0);
console.log(order.onPaid?.());
console.log(order.items?.[0]?.title);

Граница непрерывной цепочки

Вывод: undefined, затем два TypeError. Снимите скобки вокруг item?.delivery: первый ошибочный вариант станет безопасной цепочкой.

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 item = null;
console.log(item?.delivery.price);
for (const read of [() => (item?.delivery).price, () => ({ run: 1 }).run?.()]) {
  try { read(); } catch (error) { console.log(error.name); }
}

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

ECMAScript: Optional Chains.