CKTIS / JavaScript
Object.getOwnPropertyDescriptors — descriptors van eigen eigenschappen
Voor een gewoon object geeft Object.getOwnPropertyDescriptors de descriptors van alle eigen eigenschappen terug, ook van niet-enumerabele eigenschappen en eigenschappen met Symbol-sleutels. Gebruik de methode om kenmerken te bekijken of eigenschappen te kopiëren zonder accessors in waarden om te zetten.
Versie: 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) geeft een nieuw gewoon object terug. De methode haalt bij obj de lijst met sleutels van eigen eigenschappen op en neemt voor elke sleutel in die lijst de descriptor op als obj er een meldt. Dit geldt voor tekenreeks- en Symbol-sleutels, ook die van niet-enumerabele eigenschappen; overgeërfde eigenschappen worden uitgesloten.
Een descriptor van een data-eigenschap bevat value, writable, enumerable en configurable. Een accessor-descriptor bevat get en set in plaats van value en writable; een ontbrekende functie wordt weergegeven als undefined. Het lezen van de descriptors van een gewoon object roept de getters niet aan. Bij een Proxy kunnen echter traps worden uitgevoerd en uitzonderingen optreden. Het resultaat kan ook onvolledig zijn zonder dat er een uitzondering optreedt: de ownKeys-trap kan de sleutel van een configureerbare eigen eigenschap van een uitbreidbaar doelobject weglaten, zelfs als de proxy voor die sleutel nog steeds een descriptor van een eigen eigenschap meldt. De methode laat die descriptor dan weg uit het resultaat.
Voor een gewoon object maakt het patroon Object.create(Object.getPrototypeOf(obj), Object.getOwnPropertyDescriptors(obj)) een ondiepe kopie met hetzelfde prototype en dezelfde kenmerken van de eigen eigenschappen. Anders dan Object.assign behoudt het accessors en niet-enumerabele eigenschappen. Geneste objecten blijven gedeeld; dit is geen algemene kloonmethode voor objecten die afhankelijk zijn van interne slots, zoals Map.
null en undefined veroorzaken een TypeError; andere primitieve waarden worden verpakt als objecten. De methode hoort bij ECMAScript 2017, niet bij Web APIs. Ondersteuning in de doelbrowser moet afzonderlijk worden gecontroleerd — beschikbaarheid in Node 24 bewijst die niet.
Voorbeelden
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);Resultaat
0 7 false function 14 1 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.