CKTIS / JavaScript
Object.getOwnPropertyDescriptor — kontrola vlastní vlastnosti
Object.getOwnPropertyDescriptor vrací popis vlastní vlastnosti objektu: její hodnotu nebo přístupové funkce a příznaky jejích atributů. Řetězec prototypů neprohledává a vrací undefined, pokud objekt danou vlastní vlastnost nemá.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) přečte deskriptor jedné vlastní vlastnosti, včetně neenumerovatelné. Prototypy neprohledává. Výsledkem je nový objekt deskriptoru, nebo undefined, pokud se vlastnost nenachází přímo v obj. I existující vlastnost s hodnotou undefined má stále svůj deskriptor.
Deskriptor datové vlastnosti obsahuje value, writable, enumerable a configurable. Deskriptor přístupové vlastnosti obsahuje místo value a writable položky get a set; chybějící přístupová funkce má hodnotu undefined. U běžného objektu přečtení deskriptoru getter nevyvolá. writable určuje, zda přiřazení může změnit hodnotu, enumerable, zda se vlastnost zahrne do výčtu, a configurable, zda lze vlastnost odstranit nebo překonfigurovat.
Změna polí vráceného objektu nezmění původní vlastnost. Chcete-li deskriptor použít, použijte Object.defineProperty a berte v úvahu omezení existující vlastnosti. Deskriptor není hluboká kopie: objekt uložený v value zůstává stejnou referencí.
key se převede na klíč vlastnosti: řetězec nebo symbol. Předání null nebo undefined jako obj vyvolá TypeError; ostatní primitivní hodnoty se zabalí do objektů. U Proxy může operace vyvolat past getOwnPropertyDescriptor, takže může mít vedlejší účinky nebo vyvolat výjimku.
Pří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ýsledek
42 false true true 42 undefined
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.