CKTIS / JavaScript
Object.getOwnPropertyDescriptors — deskriptorji lastnih lastnosti
Pri navadnem objektu Object.getOwnPropertyDescriptors vrne deskriptorje vseh njegovih lastnih lastnosti, tudi lastnosti z atributom `enumerable`, nastavljenim na `false`, in lastnosti s ključi Symbol. Z njim lahko pregledujemo atribute ali kopiramo lastnosti, ne da bi dostopnike pretvorili v vrednosti.
Različica: 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) vrne nov navaden objekt. Metoda od obj pridobi seznam ključev lastnih lastnosti in za vsak ključ na seznamu v rezultat vključi ustrezni deskriptor, če ga obj poda. Upošteva lastnosti z nizovnimi ključi in ključi vrste Symbol, tudi tiste z atributom enumerable, nastavljenim na false; podedovane lastnosti so izključene.
Deskriptor podatkovne lastnosti vsebuje value, writable, enumerable in configurable. Deskriptor dostopnika namesto value in writable vsebuje polji get in set; manjkajoča funkcija je predstavljena z undefined. Branje deskriptorjev navadnega objekta ne pokliče njegovih getterjev. Pri objektu Proxy pa se lahko sprožijo pasti in pride do izjem. Rezultat je lahko nepopoln tudi brez izjeme: past ownKeys lahko izpusti ključ nastavljive lastne lastnosti razširljivega ciljnega objekta, tudi če proxy za ta ključ še vedno poda deskriptor lastne lastnosti. Metoda tega deskriptorja potem ne vključi v rezultat.
Pri navadnem objektu vzorec Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) ustvari plitvo kopijo z enakim prototipom in atributi lastnih lastnosti. V nasprotju z Object.assign ohrani dostopnike in lastnosti z atributom enumerable, nastavljenim na false. Ugnezdeni objekti ostanejo v skupni rabi; to ni splošna tehnika za kloniranje objektov, odvisnih od notranjih rež, kot je Map.
null in undefined povzročita TypeError; druge primitivne vrednosti se ovijejo v objekte. Metoda je del ECMAScript 2017, ne Web APIs. Podporo v ciljnem brskalniku je treba preveriti posebej — razpoložljivost v Node 24 tega ne dokazuje.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.