Как называется проверка вида if ('payload' in data) и для чего она используется?

Оператор in в JavaScript проверяет, существует ли указанное свойство в объекте. Выражение 'payload' in data возвращает true, если ключ payload присутствует в объекте data или в его цепочке прототипов, и false в противном случае. Это принципиально отличается от простого чтения data.payload, которое вернёт undefined как для отсутствующего свойства, так и для свойства со значением undefined.

Зачем нужна такая проверка

• Безопасный доступ к необязательным полям конфигураций, ответов API, опций функций.
• Различие между «свойства нет» и «свойство есть, но равно undefined».
• Защита от ошибок при работе с динамическими структурами данных.

Пример использования

function handle(data) {
  if ('payload' in data) {
    // свойство существует, можно безопасно работать
    console.log('Payload:', data.payload);
  } else {
    console.log('Payload отсутствует');
  }
}

handle({ payload: undefined }); // Payload: undefined
handle({});                     // Payload отсутствует

Важные нюансы

Оператор in учитывает цепочку прототипов, поэтому 'toString' in {} вернёт true. Если нужно проверить только собственные свойства объекта, используют Object.prototype.hasOwnProperty.call(data, 'payload') или Object.hasOwn(data, 'payload').

Итог: проверку 'key' in obj стоит применять, когда важно точно знать, объявлено ли свойство в объекте, особенно при работе с опциональными полями и динамическими данными.