База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Оператор in — проверка за наличие на свойство

Операторът `in` проверява дали има свойство с даден ключ, а не каква е стойността му. Ако обектът и всички обекти във веригата му от прототипи са обикновени обекти, проверката обхваща както собствените, така и наследените свойства. Капанът `has` на `Proxy` може да промени резултата. Десният операнд трябва да е обект; примитивна стойност предизвиква `TypeError`.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

propertyKey in object
#privateName in object

Ако обектът и всички обекти във веригата му от прототипи са обикновени обекти, propertyKey in object връща true за собствено или наследено свойство, а в противен случай — false. Левият операнд се преобразува в ключ на свойство: низ или Symbol. Десният операнд трябва да е обект; null, undefined и примитивните низове също предизвикват TypeError.

Капанът has на Proxy може да прихване проверката на ключа, включително по време на търсене във веригата от прототипи. Например той може да отчете като наличен ключ, който липсва както в целевия обект, така и в прототипите му, или да скрие съществуващо конфигурируемо собствено свойство на разширяем целеви обект.

Наличието не означава, че стойността е различна от undefined: свойство с такава стойност все пак съществува. За проверка само на собствените свойства използвай Object.hasOwn(object, propertyKey). Операторът in включва и неизброимите свойства; той не е цикъл for...in.

При масивите in проверява ключовете на индексите, а не дали дадена стойност се среща. Празна позиция, оставена от delete, не е собствен елемент на масива, дори индексът ѝ да е по-малък от length. Ако никой Proxy не прихване проверката и търсенето не намери ключа и във веригата от прототипи, резултатът е false.

Отделният синтаксис #privateName in object проверява дали присъства конкретен частен елемент, а не свойство с текстов ключ. Частното име трябва да е декларирано в областта на видимост на клас, която обхваща израза; десният операнд все пак трябва да е обект.

Примери

const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;

console.log("own" in item);
console.log("inherited" in item);
console.log("missing" in item);
console.log(Object.hasOwn(item, "inherited"));

const values = [undefined];
console.log(0 in values);
delete values[0];
console.log(0 in values);

Резултат

true
true
false
false
true
false

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници