CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — preskúmanie vlastnej vlastnosti
Reflect.getOwnPropertyDescriptor(target, key) vracia deskriptor vlastnej vlastnosti alebo undefined. Umožňuje preskúmať hodnotu, prístupové funkcie a atribúty vlastnosti bez prehľadávania reťazca prototypov.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) opisuje iba vlastnú vlastnosť objektu target, aj keď nie je enumerovateľná. Vráti nový objekt deskriptora alebo undefined, ak vlastnosť nie je vlastná. Zdedená vlastnosť sa v reťazci prototypov nevyhľadáva; aj vlastná vlastnosť s hodnotou undefined má deskriptor.
Dátový deskriptor obsahuje value, writable, enumerable a configurable. Deskriptor prístupovej vlastnosti obsahuje namiesto value a writable položky get a set; ich hodnotami sú funkcie alebo undefined. Preskúmanie deskriptora bežného objektu nevyvolá jeho getter. Úprava vráteného deskriptora sama osebe vlastnosť nedefinuje nanovo; na to možno použiť napríklad Object.defineProperty.
target musí byť objekt; každá primitívna hodnota vrátane null a undefined spôsobí TypeError. To sa líši od Object.getOwnPropertyDescriptor, ktorý obaľuje primitívne hodnoty okrem null a undefined. Operácia ToPropertyKey prevádza key na kľúč vlastnosti. Ak je key objekt, operácia ho najprv prevedie na primitívnu hodnotu, napríklad volaním jeho metódy Symbol.toPrimitive. Ak je primitívnou hodnotou symbol, použije sa ako kľúč bez zmeny; inak sa hodnota prevedie na reťazec.
Nepredpokladajte, že operácia je vždy bez vedľajších účinkov: prevod key môže spustiť používateľský kód a objekt Proxy môže aktivovať svoju pascu getOwnPropertyDescriptor. Výsledné výnimky sa propagujú volajúcemu. Príklad ukazuje, že zdedená vlastnosť sa ignoruje a zmena descriptor.value nezmení item.score.
Príklady
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);Výsledok
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.