CKTIS / JavaScript
Operátor in – kontrola existence vlastnosti
Operátor `in` podle klíče zjišťuje, zda vlastnost existuje, nikoli jakou má hodnotu. Pokud jsou objekt i všechny objekty v jeho řetězci prototypů běžné objekty, zahrnuje vlastní i zděděné vlastnosti. Obslužná funkce `has` objektu `Proxy` může výsledek změnit. Pravý operand musí být objekt; primitivní hodnota způsobí `TypeError`.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
propertyKey in object
#privateName in objectPokud jsou objekt i všechny objekty v jeho řetězci prototypů běžné objekty, vrací propertyKey in object hodnotu true pro vlastní nebo zděděnou vlastnost, jinak vrací false. Levý operand se převede na klíč vlastnosti: řetězec nebo Symbol. Pravý operand musí být objekt; také null, undefined a primitivní řetězce způsobí TypeError.
Obslužná funkce has objektu Proxy může kontrolu klíče zachytit, a to i při prohledávání řetězce prototypů. Může například ohlásit přítomnost klíče, který není ani v cílovém objektu, ani v jeho prototypech, nebo skrýt existující konfigurovatelnou vlastní vlastnost rozšiřitelného cílového objektu.
Existence neznamená, že hodnota je jiná než undefined: vlastnost s touto hodnotou stále existuje. Chcete-li kontrolovat pouze vlastní vlastnosti, použijte Object.hasOwn(object, propertyKey). Operátor in zahrnuje také neenumerovatelné vlastnosti; nejde o cyklus for...in.
U polí kontroluje in klíče indexů, nikoli výskyt hodnoty. Mezery vzniklé po delete nejsou vlastními prvky pole, ani když jsou jejich indexy menší než length. Pokud kontrolu nezachytí žádný Proxy a klíč se nenajde ani v řetězci prototypů, výsledek je false.
Samostatná syntaxe #privateName in object kontroluje přítomnost konkrétního soukromého prvku, nikoli vlastnosti s řetězcovým klíčem. Soukromý název musí být deklarován v oboru platnosti třídy, který výraz obklopuje; pravý operand musí být stále objekt.
Pří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ýsledek
true true false false true false
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.