Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 object

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

Zdroje