Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

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

Object.getOwnPropertyDescriptor zwraca opis własnej właściwości obiektu: jej wartość albo akcesory oraz flagi atrybutów. Pomija łańcuch prototypów i zwraca undefined, gdy obiekt nie ma takiej własnej właściwości.

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

Object.getOwnPropertyDescriptor(obj, key)

Object.getOwnPropertyDescriptor(obj, key) odczytuje deskryptor jednej własnej właściwości, również nieenumerowalnej. Nie przeszukuje prototypów. Wynikiem jest nowy obiekt deskryptora albo undefined, jeśli właściwości nie ma bezpośrednio w obj. Właściwość istniejąca z wartością undefined nadal ma deskryptor.

Deskryptor właściwości danych zawiera value, writable, enumerable i configurable. Deskryptor właściwości akcesorowej zamiast value i writable zawiera get i set; brakujący akcesor ma wartość undefined. Dla zwykłego obiektu samo odczytanie deskryptora nie wywołuje gettera. writable określa możliwość zmiany wartości przez przypisanie, enumerable — uwzględnianie w enumeracji, a configurable — możliwość usunięcia lub rekonfiguracji właściwości.

Zmiana pól zwróconego obiektu nie zmienia właściwości źródłowej. Aby zastosować deskryptor, użyj Object.defineProperty, z uwzględnieniem ograniczeń istniejącej właściwości. Deskryptor nie jest głęboką kopią: obiekt przechowywany w value pozostaje tą samą referencją.

key jest konwertowany do klucza właściwości: stringa lub symbolu. null i undefined jako obj powodują TypeError; pozostałe wartości prymitywne są opakowywane w obiekty. Dla Proxy operacja może uruchomić pułapkę getOwnPropertyDescriptor, więc może mieć skutki uboczne lub rzucić wyjątek.

Przykłady

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

const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));

Wynik

42 false
true true
42
undefined

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

Źródła