CKTIS / JavaScript
Reflect.has — sprawdzanie istnienia właściwości
`Reflect.has(target, propertyKey)` zwraca wartość logiczną. Gdy obiekt i wszystkie jego prototypy są zwykłymi obiektami, metoda odróżnia brak właściwości od istnienia właściwości własnej lub odziedziczonej, nawet jeśli jej wartością jest `undefined`. Pułapka `has` w obiekcie `Proxy` może zmienić wynik.
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
Reflect.has(target, propertyKey)Reflect.has(target, propertyKey) sprawdza istnienie właściwości, a nie jej wartość. Gdy obiekt i wszystkie jego prototypy są zwykłymi obiektami, metoda przeszukuje obiekt i jego łańcuch prototypów, a następnie zwraca true albo false. Właściwość o wartości undefined nadal istnieje; jej wyliczalność nie ma znaczenia.
To funkcyjny odpowiednik propertyKey in target. Jeśli interesują Cię wyłącznie właściwości własne, użyj Object.hasOwn(target, propertyKey): w przeciwieństwie do Reflect.has nie uwzględnia on właściwości odziedziczonych.
target musi być obiektem; wartość prymitywna, w tym null lub undefined, powoduje TypeError. propertyKey jest przekształcany w klucz właściwości: ciąg znaków lub symbol. Przykładowo liczba 0 wskazuje klucz "0". Błędy konwersji są przekazywane do wywołującego.
Metoda wywołuje wewnętrzną operację [[HasProperty]]. Jeśli podczas sprawdzania napotka obiekt Proxy, może uruchomić jego pułapkę has. Pułapka może zmienić wynik logiczny: może zgłosić nieistniejącą właściwość jako obecną lub ukryć istniejącą konfigurowalną właściwość własną rozszerzalnego obiektu docelowego. Sprawdzenie może też mieć skutki uboczne lub rzucić wyjątek. W przykładzie own istnieje mimo wartości undefined, a inherited jest znajdowane tylko przez sprawdzenie uwzględniające prototyp.
Przykłady
const parent = { inherited: 42 };
const item = Object.create(parent);
item.own = undefined;
console.log(Reflect.has(item, "own"));
console.log(Reflect.has(item, "inherited"));
console.log(Reflect.has(item, "missing"));
console.log(Object.hasOwn(item, "inherited"));Wynik
true true false false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.