Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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 object

Ak 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.

Zdroje