Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Reflect.getOwnPropertyDescriptor — deskryptor własnej właściwości

Reflect.getOwnPropertyDescriptor(target, key) zwraca deskryptor własnej właściwości obiektu albo undefined. Pozwala sprawdzić wartość, akcesory i atrybuty właściwości bez przeszukiwania łańcucha prototypów.

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.getOwnPropertyDescriptor(target, key)

Reflect.getOwnPropertyDescriptor(target, key) opisuje wyłącznie własną właściwość target, również nieenumerowalną. Zwraca nowy obiekt deskryptora albo undefined, jeśli właściwość nie jest własna. Właściwość odziedziczona nie jest wyszukiwana w łańcuchu prototypów; własna właściwość o wartości undefined nadal ma deskryptor.

Deskryptor danych zawiera value, writable, enumerable i configurable. Deskryptor akcesorowy zawiera zamiast value i writable pola get oraz set, których wartościami są funkcje lub undefined. Odczyt deskryptora zwykłego obiektu nie wywołuje gettera. Zmiana zwróconego deskryptora sama w sobie nie redefiniuje właściwości; do tego służy na przykład Object.defineProperty.

target musi być obiektem; każda wartość pierwotna, w tym null i undefined, powoduje TypeError. To różnica względem Object.getOwnPropertyDescriptor, które opakowuje wartości pierwotne poza null i undefined. Operacja ToPropertyKey konwertuje argument key na klucz właściwości. Jeśli key jest obiektem, najpierw konwertuje go na wartość pierwotną, na przykład za pomocą metody Symbol.toPrimitive. Jeśli wartość pierwotna jest symbolem, zostaje zachowana jako klucz; w przeciwnym razie jest konwertowana na ciąg znaków.

Nie traktuj tej operacji jako zawsze pozbawionej efektów ubocznych: konwersja key może uruchomić kod użytkownika, a obiekt Proxy może uruchomić pułapkę getOwnPropertyDescriptor. Powstałe wyjątki są przekazywane wywołującemu. Przykład pokazuje pomijanie właściwości odziedziczonej i to, że zmiana descriptor.value nie zmienia item.score.

Przykłady

const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);

Wynik

{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła