CKTIS / JavaScript
Reflect.getOwnPropertyDescriptor — een eigen eigenschap inspecteren
Reflect.getOwnPropertyDescriptor(target, key) geeft de descriptor van een eigen eigenschap terug, of undefined. Hiermee kun je de waarde, accessors en kenmerken van een eigenschap bekijken zonder de prototypeketen te doorzoeken.
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
Reflect.getOwnPropertyDescriptor(target, key)Reflect.getOwnPropertyDescriptor(target, key) beschrijft alleen een eigen eigenschap van target, ook als die niet opsombaar is. De functie geeft een nieuw descriptorobject terug, of undefined als de eigenschap geen eigen eigenschap is. Een overgeërfde eigenschap wordt niet in de prototypeketen opgezocht; ook een eigen eigenschap met de waarde undefined heeft een descriptor.
Een gegevensdescriptor bevat value, writable, enumerable en configurable. Een accessordescriptor bevat get en set in plaats van value en writable; de waarden daarvan zijn functies of undefined. Het inspecteren van de descriptor van een gewoon object roept de getter niet aan. De teruggegeven descriptor wijzigen herdefinieert de eigenschap niet; gebruik daarvoor bijvoorbeeld Object.defineProperty.
target moet een object zijn; elke primitieve waarde, waaronder null en undefined, veroorzaakt een TypeError. Dit verschilt van Object.getOwnPropertyDescriptor, dat primitieve waarden behalve null en undefined omzet in objecten. De bewerking ToPropertyKey zet key om in een eigenschapssleutel. Als key een object is, zet de bewerking het eerst om in een primitieve waarde, bijvoorbeeld door de methode Symbol.toPrimitive van het object aan te roepen. Is de primitieve waarde een symbool, dan blijft dat symbool behouden als sleutel; anders wordt de waarde omgezet in een tekenreeks.
Ga er niet van uit dat de bewerking altijd zonder neveneffecten is: het omzetten van key kan gebruikerscode uitvoeren en een Proxy kan zijn getOwnPropertyDescriptor-val activeren. Uitzonderingen die daardoor ontstaan, worden doorgegeven aan de aanroeper. Het voorbeeld laat zien dat een overgeërfde eigenschap wordt genegeerd en dat het wijzigen van descriptor.value item.score niet verandert.
Voorbeelden
const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);Resultaat
{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42De 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.