CKTIS / JavaScript
Operator in – preverjanje obstoja lastnosti
Operator `in` po ključu preveri, ali lastnost obstaja, ne pa, kakšno vrednost ima. Če so objekt in vsi objekti v njegovi verigi prototipov običajni objekti, upošteva lastne in podedovane lastnosti. Prestrezna funkcija `has` objekta `Proxy` lahko spremeni rezultat. Desni operand mora biti objekt; primitivna vrednost povzroči `TypeError`.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
propertyKey in object
#privateName in objectČe so objekt in vsi objekti v njegovi verigi prototipov običajni objekti, propertyKey in object vrne true za lastno ali podedovano lastnost, sicer pa false. Levi operand se pretvori v ključ lastnosti: niz ali Symbol. Desni operand mora biti objekt; tudi null, undefined in primitivni nizi povzročijo TypeError.
Prestrezna funkcija has objekta Proxy lahko prestreže preverjanje ključa, tudi med iskanjem po verigi prototipov. Tako lahko na primer sporoči, da je ključ prisoten, čeprav ga ni niti v ciljnem objektu niti v njegovih prototipih, ali skrije obstoječo nastavljivo lastno lastnost razširljivega ciljnega objekta.
Obstoj ne pomeni, da je vrednost različna od undefined: lastnost s to vrednostjo še vedno obstaja. Če želiš preveriti samo lastne lastnosti, uporabi Object.hasOwn(object, propertyKey). Operator in upošteva tudi lastnosti, ki jih ni mogoče našteti; ni zanka for...in.
Pri poljih operator in preverja ključe indeksov, ne prisotnosti vrednosti. Vrzel, ki jo pusti delete, ni lastni element polja, tudi če je njen indeks manjši od length. Če preverjanja ne prestreže noben Proxy in iskanje ključa ne najde niti v verigi prototipov, je rezultat false.
Ločena sintaksa #privateName in object preverja prisotnost določenega zasebnega elementa, ne lastnosti z besedilnim ključem. Zasebno ime mora biti deklarirano v dosegu razreda, ki obdaja izraz; desni operand mora biti še vedno objekt.
Primeri
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);Rezultat
true true false false true false
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.