Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje