Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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 object

Jeś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.

Źródła