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.