CKTIS / JavaScript
Object.getOwnPropertyDescriptor — een eigen eigenschap inspecteren
Object.getOwnPropertyDescriptor geeft een beschrijving van een eigen eigenschap van een object: de waarde of accessors ervan, plus de attribuutvlaggen. De methode doorzoekt de prototypeketen niet en geeft undefined terug als het object die eigen eigenschap niet heeft.
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.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) leest de descriptor van één eigen eigenschap, ook als die niet opsombaar is. De methode doorzoekt geen prototypes. Het resultaat is een nieuw descriptorobject, of undefined als de eigenschap niet rechtstreeks in obj staat. Een bestaande eigenschap met de waarde undefined heeft nog steeds een descriptor.
Een descriptor van een data-eigenschap bevat value, writable, enumerable en configurable. Een descriptor van een accessor-eigenschap bevat get en set in plaats van value en writable; een ontbrekende accessor heeft de waarde undefined. Bij een gewoon object roept het lezen van de descriptor de getter niet aan. writable bepaalt of een toewijzing de waarde kan wijzigen, enumerable of de eigenschap wordt meegenomen bij enumeratie en configurable of de eigenschap kan worden verwijderd of opnieuw geconfigureerd.
Wijzigingen aan de velden van het geretourneerde object veranderen de oorspronkelijke eigenschap niet. Gebruik Object.defineProperty om een descriptor toe te passen, met inachtneming van de beperkingen van de bestaande eigenschap. De descriptor is geen diepe kopie: een object dat in value is opgeslagen, blijft dezelfde verwijzing.
key wordt omgezet in een eigenschapssleutel: een string of symbool. null of undefined doorgeven als obj veroorzaakt een TypeError; andere primitieve waarden worden verpakt als objecten. Bij een Proxy kan de bewerking de getOwnPropertyDescriptor-trap aanroepen, waardoor er neveneffecten kunnen optreden of een uitzondering kan worden gegooid.
Voorbeelden
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"));Resultaat
42 false true true 42 undefined
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.