CKTIS / JavaScript
Object.getOwnPropertyDescriptor — kontrola vlastnej vlastnosti
Object.getOwnPropertyDescriptor vracia opis vlastnej vlastnosti objektu: jej hodnotu alebo prístupové funkcie a príznaky jej atribútov. Reťazec prototypov neprehľadáva a vráti undefined, ak objekt danú vlastnú vlastnosť nemá.
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
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) prečíta deskriptor jednej vlastnej vlastnosti, aj keď nie je enumerovateľná. Prototypy neprehľadáva. Výsledkom je nový objekt deskriptora alebo undefined, ak sa vlastnosť nenachádza priamo v obj. Aj existujúca vlastnosť s hodnotou undefined má stále svoj deskriptor.
Deskriptor dátovej vlastnosti obsahuje value, writable, enumerable a configurable. Deskriptor prístupovej vlastnosti obsahuje namiesto value a writable položky get a set; chýbajúca prístupová funkcia má hodnotu undefined. Pri bežnom objekte čítanie deskriptora getter nevyvolá. writable určuje, či priradenie môže zmeniť hodnotu, enumerable, či sa vlastnosť zahrnie do enumerácie, a configurable, či možno vlastnosť odstrániť alebo prekonfigurovať.
Zmeny polí vráteného objektu nezmenia pôvodnú vlastnosť. Ak chcete deskriptor použiť, použite Object.defineProperty a zohľadnite obmedzenia existujúcej vlastnosti. Deskriptor nie je hlboká kópia: objekt uložený v value zostáva tou istou referenciou.
key sa prevedie na kľúč vlastnosti: reťazec alebo symbol. Odovzdanie null alebo undefined ako obj vyvolá TypeError; ostatné primitívne hodnoty sa zabalia do objektov. Pri Proxy môže operácia vyvolať pascu getOwnPropertyDescriptor, takže môže mať vedľajšie účinky alebo vyvolať výnimku.
Príklady
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"));Výsledok
42 false true true 42 undefined
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.