CKTIS / JavaScript
Object.getOwnPropertyDescriptor — pregled lastne lastnosti
Object.getOwnPropertyDescriptor vrne opis lastne lastnosti objekta: njeno vrednost ali dostopnike ter oznake njenih atributov. Ne išče po verigi prototipov in vrne undefined, če objekt nima te lastne lastnosti.
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.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) prebere deskriptor ene lastne lastnosti, tudi če ni našteta. Po prototipih ne išče. Rezultat je nov objekt deskriptorja ali undefined, če lastnost ni neposredno v obj. Tudi obstoječa lastnost z vrednostjo undefined ima še vedno deskriptor.
Deskriptor podatkovne lastnosti vsebuje value, writable, enumerable in configurable. Deskriptor dostopne lastnosti namesto value in writable vsebuje get in set; manjkajoči dostopnik ima vrednost undefined. Pri običajnem objektu branje deskriptorja ne pokliče getterja. writable določa, ali lahko dodelitev spremeni vrednost, enumerable, ali je lastnost vključena v naštevanje, configurable pa, ali je lastnost mogoče izbrisati ali ponovno konfigurirati.
Spreminjanje polj vrnjenega objekta ne spremeni izvorne lastnosti. Če želite uporabiti deskriptor, uporabite Object.defineProperty in upoštevajte omejitve obstoječe lastnosti. Deskriptor ni globoka kopija: objekt, shranjen v value, ostane ista referenca.
key se pretvori v ključ lastnosti: niz ali simbol. Če je kot obj podan null ali undefined, se sproži TypeError; druge primitivne vrednosti se ovijejo v objekte. Pri Proxy lahko operacija pokliče past getOwnPropertyDescriptor, zato ima lahko stranske učinke ali sproži izjemo.
Primeri
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"));Rezultat
42 false true true 42 undefined
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.