KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen