CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — pregled lastne lastnosti
Reflect.getOwnPropertyDescriptor(target, key) vrne deskriptor lastne lastnosti ali undefined. Omogoča pregled vrednosti, dostopnikov in atributov lastnosti, ne da bi preiskal verigo prototipov.
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
Reflect.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) opisuje samo lastno lastnost objekta target, tudi če ni našteta. Vrne nov objekt deskriptorja ali undefined, če lastnost ni lastna. Podedovane lastnosti ne išče po verigi prototipov; tudi lastna lastnost z vrednostjo undefined ima deskriptor.
Podatkovni deskriptor vsebuje value, writable, enumerable in configurable. Deskriptor dostopnika namesto value in writable vsebuje polji get in set; njuni vrednosti sta funkciji ali undefined. Pregled deskriptorja običajnega objekta ne prikliče njegovega getterja. Spreminjanje vrnjenega deskriptorja samo po sebi ne na novo določi lastnosti; za to uporabite na primer Object.defineProperty.
target mora biti objekt; vsaka primitivna vrednost, tudi null in undefined, povzroči TypeError. To se razlikuje od Object.getOwnPropertyDescriptor, ki ovije primitivne vrednosti, razen null in undefined. Operacija ToPropertyKey pretvori key v ključ lastnosti. Če je key objekt, ga najprej pretvori v primitivno vrednost, na primer s klicem njegove metode Symbol.toPrimitive. Če je primitivna vrednost simbol, ga uporabi kot ključ brez spremembe; sicer vrednost pretvori v niz.
Ne predpostavljajte, da je operacija vedno brez stranskih učinkov: pretvorba key lahko izvede uporabniško kodo, objekt Proxy pa lahko sproži svojo past getOwnPropertyDescriptor. Nastale izjeme se posredujejo klicatelju. Primer pokaže, da je podedovana lastnost prezrta in da sprememba descriptor.value ne spremeni item.score.
Primeri
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Rezultat
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.