KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Reflect — expliciete objectbewerkingen

Reflect biedt statische methoden om objecten te lezen, te wijzigen en te onderzoeken. Met de booleaanse uitkomst van een schrijfbewerking kun je controleren of de bewerking is gelukt, maar dat betekent niet dat de methode nooit een uitzondering kan veroorzaken.

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.get(target, key[, receiver])
Reflect.set(target, key, value[, receiver])
Reflect.defineProperty(target, key, descriptor)
Reflect.ownKeys(target)

Reflect is een ingebouwd ECMAScript-object, geen functie of constructor: Reflect() en new Reflect() veroorzaken een TypeError. De methoden bieden bewerkingen die overeenkomen met de interne mechanismen van objecten.

Reflect.get leest een eigenschap, terwijl Reflect.set probeert deze te schrijven en een boolean retourneert, niet de toegewezen waarde. De optionele parameter receiver is bij beide methoden standaard gelijk aan target en bepaalt de waarde van this wanneer getters of setters worden aangeroepen. Reflect.ownKeys retourneert alle eigen sleutels van het type string en symbool, ook niet-enumerabele; overgeërfde sleutels worden uitgesloten.

Reflect.defineProperty retourneert false wanneer een object een geldige descriptor afwijst, terwijl Object.defineProperty in die situatie een uitzondering veroorzaakt. Een booleaanse uitkomst garandeert niet dat er geen uitzonderingen optreden: ongeldige argumenten en code in getters, setters of Proxy-traps kunnen ze veroorzaken. Bewerkingen op eigenschappen vereisen een object als target.

In het voorbeeld is de eigenschap niet-enumerabel en niet beschrijfbaar. Reflect.set retourneert ook in strict mode false, de waarde blijft 10 en Reflect.ownKeys vindt de sleutel nog steeds.

Voorbeelden

"use strict";
const target = {};
Reflect.defineProperty(target, "score", {
  value: 10,
  writable: false,
  enumerable: false,
  configurable: false
});
console.log(Reflect.get(target, "score"));
console.log(Reflect.set(target, "score", 20));
console.log(Reflect.ownKeys(target).join(","));
console.log(Reflect.get(target, "score"));

Resultaat

10
false
score
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.

Bronnen