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

Опциональная цепочка ?. — это безопасный способ доступа к свойствам вложенных объектов, даже если какое-либо из промежуточных свойств не существует.

Проблема «несуществующего свойства»

Если вы только начали читать учебник и изучать JavaScript, то, возможно, эта проблема вам пока незнакома, но она достаточно распространена.

Например, рассмотрим объекты для пользователей user. У большинства пользователей есть адрес user.address с улицей user.address.street, но некоторые адрес не указали.

В этом случае при попытке получить свойство user.address.street будет ошибка:

let user = {}; // пользователь без свойства address

alert(user.address.street); // ошибка!

Это нормальный результат, так работает JavaScript, но во многих реальных ситуациях удобнее было бы получать не ошибку, а просто undefined («нет улицы»).

Или ещё пример. В веб-разработке нам бывает нужно получить данные об HTML-элементе, который иногда может отсутствовать на странице:

// Произойдёт ошибка, если querySelector(...) равен null.
let html = document.querySelector('.my-element').innerHTML;

До появления ?. в языке для решения подобных проблем использовался оператор &&.

Например:

let user = {}; // пользователь без адреса

alert( user && user.address && user.address.street ); // undefined (без ошибки)

Использование логического И со всей цепочкой свойств гарантирует, что все они существуют (а если нет – вычисление прекращается), но это довольно длинная и громоздкая конструкция.

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

Опциональная цепочка ?. останавливает вычисление и возвращает undefined, если часть перед ?. имеет значение undefined или null.

Для краткости в этой статье мы будем говорить о значении, что оно «существует», если оно отличается от null или undefined.

Вот безопасный способ обратиться к свойству user.address.street:

let user = {}; // пользователь без адреса

alert( user?.address?.street ); // undefined (без ошибки)

Чтение адреса с помощью конструкции user?.address выполняется без ошибок, даже если объекта user не существует:

let user = null;

alert( user?.address ); // undefined
alert( user?.address.street ); // undefined

Обратите внимание, что синтаксис ?. делает необязательным только свойство перед ним, а не какое-либо последующее.

В приведённом выше примере конструкция user?. допускает, что переменная user может содержать null/undefined.

С другой стороны, если объект user существует, то в нём должно быть свойство user.address, иначе выполнение user?.address.street вызовет ошибку из-за второй точки.

// ReferenceError: user is not defined
user?.address;

Сокращённое вычисление

Как уже говорилось, ?. немедленно останавливает вычисление, если левой части не существует.

Таким образом, последующие вызовы функций или операции не будут выполнены.

Например:

let user = null;
let x = 0;

user?.sayHi(x++); // нет user, поэтому до x++ вычисление не дойдет

alert(x); // 0, значение не было увеличено на единицу

Другие варианты применения: ?.(), ?.[]

Опциональная цепочка ?. — это не оператор, а специальная синтаксическая конструкция, которая также работает с функциями и квадратными скобками.

Например, ?.() используется для вызова потенциально несуществующей функции.

В следующем примере не у всех пользователей есть метод admin:

let user1 = {
  admin() {
    alert("Я администратор");
  }
}

let user2 = {};

user1.admin?.(); // Я администратор
user2.admin?.();

В обоих вызовах сначала используем точку (user1.admin), чтобы получить свойство admin, потому что объект пользователя точно существует, к нему можно обратиться без какой-либо ошибки.

Затем уже ?.() проверяет левую часть: если функция admin существует, то она выполнится (это так для user1). Иначе (для user2) вычисление остановится без ошибок.

Также существует синтаксис ?.[], если значение свойства требуется получить с помощью квадратных скобок [], а не через точку .. Как и в остальных случаях, такой способ позволяет защититься от ошибок при доступе к свойству объекта, которого может не быть.

let user1 = {
  firstName: "Иван"
};

let user2 = null; // Представим, что пользователь не авторизован

let key = "firstName";

alert( user1?.[key] ); // Иван
alert( user2?.[key] ); // undefined

alert( user1?.[key]?.something?.not?.existing); // undefined

Кроме этого, ?. можно использовать совместно с delete:

delete user?.name; // Удалить user.name, если пользователь существует

let user;

user?.name = "John"; // Ошибка, это не сработает
// это по сути то же самое что undefined = "John"

Итого

Синтаксис опциональной цепочки ?. имеет три формы:

1. obj?.prop – возвращает obj.prop, если существует obj, и undefined в противном случае.
2. obj?.[prop] – возвращает obj[prop], если существует obj, и undefined в противном случае.
3. obj.method?.() – вызывает obj.method(), если существует obj.method, в противном случае возвращает undefined.

Как мы видим, все они просты и понятны в использовании. ?. проверяет левую часть выражения на равенство null/undefined, и продолжает дальнейшее вычисление, только если это не так.

Цепочка ?. позволяет без возникновения ошибок обратиться к вложенным свойствам.

Тем не менее, нужно разумно использовать ?. — только там, где это уместно, если допустимо, что левая часть не существует. Чтобы таким образом не скрывать возможные ошибки программирования.