CKTIS / JavaScript
Operator in — sprawdzanie istnienia właściwości
Operator `in` sprawdza obecność właściwości o podanym kluczu, a nie jej wartość. Dla zwykłego obiektu o łańcuchu złożonym ze zwykłych prototypów uwzględnia właściwości własne i odziedziczone. Pułapka `has` obiektu `Proxy` może zmienić wynik. Prawy operand musi być obiektem; wartość prymitywna powoduje `TypeError`.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
propertyKey in object
#privateName in objectJeśli obiekt i wszystkie obiekty w jego łańcuchu prototypów są zwykłymi obiektami, propertyKey in object zwraca true, gdy właściwość jest własna lub odziedziczona, a w przeciwnym razie false. Lewy operand jest przekształcany na klucz właściwości: ciąg znaków lub Symbol. Prawy musi być obiektem; także null, undefined i prymitywne ciągi znaków powodują TypeError.
Pułapka has obiektu Proxy może przechwycić sprawdzenie klucza, również podczas przeszukiwania łańcucha prototypów. Na przykład może zgłosić obecność klucza, którego nie ma w obiekcie docelowym ani w jego prototypach, lub ukryć istniejącą konfigurowalną właściwość własną rozszerzalnego obiektu docelowego.
Istnienie nie oznacza wartości różnej od undefined: właściwość o takiej wartości nadal istnieje. Gdy interesują Cię wyłącznie właściwości własne, użyj Object.hasOwn(object, propertyKey). Operator in uwzględnia również właściwości niewyliczalne; nie jest pętlą for...in.
W tablicach in sprawdza klucze indeksów, nie obecność wartości. Luka po delete nie jest własnym elementem tablicy, nawet jeśli indeks jest mniejszy od length. Bez przechwycenia sprawdzenia przez Proxy wynik to false, jeśli sprawdzenie nie znajdzie tego klucza również w łańcuchu prototypów.
Osobna składnia #privateName in object sprawdza obecność konkretnego prywatnego elementu, a nie właściwości o kluczu tekstowym. Nazwa prywatna musi być zadeklarowana w otaczającym zakresie klasy; prawy operand nadal musi być obiektem.
Przykłady
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);Wynik
true true false false true false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.