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.