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

CKTIS / JavaScript

Object.getOwnPropertyDescriptors — deskriptory vlastních vlastností

U běžného objektu vrací Object.getOwnPropertyDescriptors deskriptory všech jeho vlastních vlastností, včetně nevyjmenovatelných vlastností a vlastností s klíči typu Symbol. Umožňuje zkoumat atributy nebo kopírovat vlastnosti, aniž by se přístupové vlastnosti převáděly na hodnoty.

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.getOwnPropertyDescriptors(obj)

Object.getOwnPropertyDescriptors(obj) vrací nový běžný objekt. Metoda získá z obj seznam klíčů vlastních vlastností a pro každý uvedený klíč zahrne do výsledku příslušný deskriptor, pokud ho obj poskytne. Zahrnuje vlastnosti s řetězcovými klíči i s klíči typu Symbol, a to i nevyjmenovatelné vlastnosti (enumerable: false); zděděné vlastnosti vynechává.

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í funkce je reprezentována jako undefined. Čtení deskriptorů běžného objektu nevolá jeho gettery. U objektu Proxy se však mohou spustit pasti a mohou nastat výjimky. Výsledek může být neúplný i bez vyvolání výjimky: past ownKeys může vynechat klíč konfigurovatelné vlastní vlastnosti rozšiřitelného cílového objektu, i když proxy pro tento klíč nadále poskytuje deskriptor vlastní vlastnosti. Metoda pak tento deskriptor do výsledku nezahrne.

U běžného objektu vzor Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) vytvoří mělkou kopii se stejným prototypem a atributy vlastních vlastností. Na rozdíl od Object.assign zachovává přístupové i nevyjmenovatelné vlastnosti. Vnořené objekty zůstávají sdílené; nejde o obecnou techniku klonování objektů závislých na interních slotech, jako je Map.

null a undefined způsobí TypeError; ostatní primitivní hodnoty se obalí do objektů. Metoda patří do ECMAScript 2017, nikoli do Web APIs. Podporu v cílovém prohlížeči je nutné ověřit zvlášť — dostupnost v Node 24 ji nedokazuje.

Příklady

let reads = 0;
const source = Object.create(null);
Object.defineProperties(source, {
  hidden: { value: 7, enumerable: false },
  doubled: {
    get() { reads += 1; return this.hidden * 2; },
    enumerable: true
  }
});
const descriptors = Object.getOwnPropertyDescriptors(source);
const copy = Object.create(Object.getPrototypeOf(source), descriptors);
console.log(reads);
console.log(descriptors.hidden.value, descriptors.hidden.enumerable);
console.log(typeof descriptors.doubled.get);
console.log(copy.doubled, reads);
console.log(Object.getPrototypeOf(copy) === null);

Výsledek

0
7 false
function
14 1
true

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