CKTIS / JavaScript
Operátor in – kontrola existencie vlastnosti
Operátor `in` podľa kľúča zisťuje, či vlastnosť existuje, nie akú má hodnotu. Ak sú objekt aj všetky objekty v jeho reťazci prototypov bežné objekty, zahŕňa vlastné aj zdedené vlastnosti. Obslužná funkcia `has` objektu `Proxy` môže výsledok zmeniť. Pravý operand musí byť objekt; primitívna hodnota spôsobí `TypeError`.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
propertyKey in object
#privateName in objectAk sú objekt aj všetky objekty v jeho reťazci prototypov bežné objekty, propertyKey in object vráti true pre vlastnú alebo zdedenú vlastnosť, inak vráti false. Ľavý operand sa prevedie na kľúč vlastnosti: reťazec alebo Symbol. Pravý operand musí byť objekt; aj null, undefined a primitívne reťazce spôsobia TypeError.
Obslužná funkcia has objektu Proxy môže zachytiť kontrolu kľúča, a to aj pri prehľadávaní reťazca prototypov. Môže napríklad ohlásiť prítomnosť kľúča, ktorý nie je ani v cieľovom objekte, ani v jeho prototypoch, alebo skryť existujúcu konfigurovateľnú vlastnú vlastnosť rozšíriteľného cieľového objektu.
Existencia neznamená, že hodnota je iná než undefined: vlastnosť s touto hodnotou stále existuje. Ak chceš kontrolovať iba vlastné vlastnosti, použi Object.hasOwn(object, propertyKey). Operátor in zahŕňa aj neenumerovateľné vlastnosti; nejde o cyklus for...in.
Pri poliach kontroluje in kľúče indexov, nie výskyt hodnoty. Medzera, ktorá vznikla po delete, nie je vlastným prvkom poľa, ani keď je jej index menší ako length. Ak kontrolu nezachytí žiadny Proxy a kľúč sa nenájde ani v reťazci prototypov, výsledok je false.
Samostatná syntax #privateName in object kontroluje prítomnosť konkrétneho súkromného prvku, nie vlastnosť s textovým kľúčom. Súkromný názov musí byť deklarovaný v rozsahu platnosti triedy, ktorý zahŕňa daný výraz; pravý operand musí byť naďalej objekt.
Príklady
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);Výsledok
true true false false true false
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.