Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — deskriptori vlastitih svojstava

Za običan objekt Object.getOwnPropertyDescriptors vraća deskriptore svih njegovih vlastitih svojstava, uključujući neenumerabilna svojstva i svojstva s ključevima Symbol. Omogućuje pregled atributa ili kopiranje svojstava bez pretvaranja pristupnika u vrijednosti.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

Object.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) vraća novi obični objekt. Metoda od objekta obj dohvaća popis ključeva vlastitih svojstava i za svaki ključ s popisa u rezultat uključuje odgovarajući deskriptor ako ga obj prijavi. Uključuje nizovne ključeve i ključeve vrste Symbol, pa i one neenumerabilnih svojstava; naslijeđena svojstva isključena su.

Deskriptor podatkovnog svojstva sadrži value, writable, enumerable i configurable. Deskriptor pristupnog svojstva umjesto value i writable sadrži polja get i set; funkcija koja nedostaje prikazuje se kao undefined. Čitanje deskriptora običnog objekta ne poziva njegove gettere. Kod objekta Proxy ipak se mogu pokrenuti zamke i mogu se pojaviti iznimke. Rezultat može biti nepotpun i bez iznimke: zamka ownKeys može izostaviti ključ konfigurabilnog vlastitog svojstva proširivog ciljnog objekta, čak i ako proxy za taj ključ i dalje prijavljuje deskriptor vlastitog svojstva. Metoda tada taj deskriptor ne uključuje u rezultat.

Za običan objekt obrazac Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) stvara plitku kopiju s istim prototipom i atributima vlastitih svojstava. Za razliku od Object.assign, čuva pristupnike i neenumerabilna svojstva. Ugniježđeni objekti ostaju zajednički; ovo nije opća tehnika kloniranja objekata koji ovise o unutarnjim slotovima, kao što je Map.

null i undefined uzrokuju TypeError; ostale primitivne vrijednosti omataju se u objekte. Metoda pripada ECMAScriptu 2017., a ne Web APIs. Podršku u ciljnom pregledniku treba zasebno provjeriti — dostupnost u Nodeu 24 ne dokazuje je.

Primjeri

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);

Rezultat

0
7 false
function
14 1
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori