CKTIS / JavaScript
Object.getOwnPropertyDescriptors — deskriptory vlastných vlastností
Pri obyčajnom objekte vracia Object.getOwnPropertyDescriptors deskriptory všetkých jeho vlastných vlastností vrátane nevymenovateľných vlastností a vlastností s kľúčmi Symbol. Umožňuje skúmať atribúty alebo kopírovať vlastnosti bez zmeny prístupových vlastností na hodnoty.
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.getOwnPropertyDescriptors(obj)Object.getOwnPropertyDescriptors(obj) vracia nový obyčajný objekt. Metóda získa z obj zoznam kľúčov vlastných vlastností a pre každý uvedený kľúč zahrnie do výsledku príslušný deskriptor, ak ho obj poskytne. Zahŕňa reťazcové kľúče aj kľúče typu Symbol, vrátane kľúčov nevymenovateľných vlastností; zdedené vlastnosti sú vylúčené.
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 funkcia je reprezentovaná ako undefined. Čítanie deskriptorov obyčajného objektu nespúšťa jeho gettery. Pri objekte Proxy sa však môžu spustiť pasce a môžu nastať výnimky. Výsledok môže byť neúplný aj bez vyvolania výnimky: pasca ownKeys môže vynechať kľúč konfigurovateľnej vlastnej vlastnosti rozšíriteľného cieľového objektu, aj keď proxy pre tento kľúč naďalej poskytuje deskriptor vlastnej vlastnosti. Metóda potom tento deskriptor do výsledku nezahrnie.
Pri obyčajnom objekte vzor Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) vytvorí plytkú kópiu s rovnakým prototypom a atribútmi vlastných vlastností. Na rozdiel od Object.assign zachováva prístupové aj nevymenovateľné vlastnosti. Vnorené objekty zostávajú zdieľané; nejde o všeobecnú techniku klonovania objektov závislých od interných slotov, ako je Map.
null a undefined spôsobia TypeError; ostatné primitívne hodnoty sa zabalia do objektov. Metóda patrí do ECMAScript 2017, nie do Web APIs. Podporu v cieľovom prehliadači treba overiť osobitne — dostupnosť v Node 24 ju nedokazuje.
Prí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ýsledok
0 7 false function 14 1 true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.