Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła