Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — deskryptory własnych właściwości

Dla zwykłego obiektu Object.getOwnPropertyDescriptors zwraca deskryptory wszystkich jego własnych właściwości, także niewyliczalnych i o kluczach typu Symbol. Pozwala analizować atrybuty oraz kopiować właściwości bez zamiany akcesorów na wartoś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.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) zwraca nowy zwykły obiekt. Metoda pobiera z obj listę kluczy własnych właściwości i dla każdego klucza umieszcza w wyniku odpowiadający mu deskryptor, jeśli obj go zgłasza. Uwzględnia klucze tekstowe i typu Symbol, także właściwości niewyliczalne; pomija właściwości odziedziczone.

Deskryptor właściwości danych zawiera value, writable, enumerable i configurable. Deskryptor akcesora zawiera zamiast value i writable pola get i set; brakująca funkcja ma wartość undefined. Odczyt deskryptorów zwykłego obiektu nie wywołuje getterów. Dla Proxy mogą jednak uruchomić się pułapki i wystąpić wyjątki. Wynik może też być niepełny bez zgłoszenia wyjątku: pułapka ownKeys może pominąć klucz konfigurowalnej własnej właściwości rozszerzalnego obiektu docelowego, nawet jeśli Proxy nadal zgłasza dla tego klucza deskryptor własnej właściwości. Metoda nie umieści wtedy tego deskryptora w wyniku.

Dla zwykłego obiektu wzorzec Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) tworzy płytką kopię z tym samym prototypem i atrybutami własnych właściwości. W przeciwieństwie do Object.assign zachowuje akcesory i właściwości niewyliczalne. Zagnieżdżone obiekty pozostają współdzielone; nie jest to ogólny sposób klonowania obiektów zależnych od wewnętrznych slotów, takich jak Map.

null i undefined powodują TypeError; pozostałe wartości pierwotne są opakowywane w obiekty. Metoda należy do ECMAScript 2017, nie do Web APIs. Wsparcie w docelowej przeglądarce wymaga osobnego sprawdzenia — obecność w Node 24 go nie dowodzi.

Przykłady

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Wynik

0
7 false
function
14 1
true

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

Źródła