CKTIS / JavaScript
Reflect.set — eigenschapstoewijzing met een booleaans resultaat
Reflect.set voert een eigenschapstoewijzing uit en geeft een boolean terug die aangeeft of deze is gelukt. Met de optionele receiver kun je het object waar de zoekactie naar een eigenschap begint onderscheiden van het object waarop wordt geschreven.
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.set(target, key, value[, receiver])Reflect.set(target, key, value[, receiver]) roept de interne [[Set]]-operatie van het object target aan. Het argument key wordt omgezet in een property key: een string of symbool. Als receiver wordt weggelaten, is de standaardwaarde target.
Het resultaat is true of false, niet de toegewezen waarde. Bij gewone objecten kan false bijvoorbeeld betekenen dat is geprobeerd een eigenschap met writable: false te wijzigen, een accessor zonder setter te gebruiken of een eigenschap toe te voegen aan een niet-uitbreidbare ontvanger. Alleen een resultaat false veroorzaakt zelfs in strict mode geen uitzondering, anders dan een afgewezen toewijzing target[key] = value in die modus.
Het zoeken naar een descriptor begint bij target en kan de prototypes ervan doorlopen. Bij een beschrijfbare data-eigenschap maakt of werkt de schrijfoperatie doorgaans een eigen eigenschap op receiver bij, rekening houdend met de beperkingen daarvan. Bij het aanroepen van een setter wordt receiver als this-argument doorgegeven. Is de setter een gewone JavaScript-functie buiten strict mode, dan krijgt this de globale this-waarde in plaats van null of undefined, en worden andere primitieve waarden omgezet in wrapperobjecten. De retourwaarde van de setter wordt genegeerd. Daarom garandeert true niet dat een latere leesbewerking value oplevert.
De methode vangt geen fouten af: een target dat geen object is, veroorzaakt een TypeError, en uitzonderingen bij de omzetting van de sleutel, uit een setter of uit een Proxy-trap worden doorgegeven. Bij het rechtstreeks definiëren van een eigen eigenschap wordt de prototypeketen niet doorzocht en worden geërfde setters niet aangeroepen. De beperkingen van de descriptor van een bestaande eigen eigenschap blijven wel gelden. Zo kun je de waarde van een eigen data-eigenschap die niet configureerbaar en niet beschrijfbaar is, niet wijzigen.
Voorbeelden
"use strict";
const target = { score: 1 };
const receiver = {};
console.log(Reflect.set(target, "score", 7, receiver));
console.log(target.score, receiver.score);
Object.defineProperty(target, "fixed", {
value: 10,
writable: false
});
console.log(Reflect.set(target, "fixed", 20));
console.log(target.fixed);Resultaat
true 1 7 false 10
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.