KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Reflect.preventExtensions — uitbreiding van een object voorkomen

Reflect.preventExtensions(target) voorkomt dat nieuwe eigen eigenschappen aan een object worden toegevoegd en geeft een Booleaanse waarde terug. Bestaande eigenschappen worden niet bevroren en er kunnen nog steeds uitzonderingen optreden.

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.preventExtensions(target)

Reflect.preventExtensions(target) roept de interne bewerking [[PreventExtensions]] van het object aan. De methode geeft true terug als de bewerking slaagt, of false als deze wordt geweigerd. Het argument moet een object zijn; een primitieve waarde, waaronder null, veroorzaakt een TypeError. Uitzonderingen van de interne bewerking worden doorgegeven: een Booleaanse uitkomst betekent niet dat uitzonderingen onmogelijk zijn.

Bij een gewoon object voorkomt succes permanent dat nieuwe eigen eigenschappen worden toegevoegd, ook eigenschappen met een Symbol-sleutel. Een volgende aanroep geeft true terug. Ook kan het prototype niet door een ander prototype worden vervangen. Bestaande eigenschappen kunnen nog worden gewijzigd of verwijderd als hun descriptors dat toestaan; geneste objecten worden niet aangepast.

Dit is niet hetzelfde als Object.seal of Object.freeze: de methode verandert de kenmerken configurable en writable niet. Object.preventExtensions geeft bij succes het argument terug en veroorzaakt een TypeError als de bewerking false oplevert; primitieve waarden geeft deze methode ongewijzigd terug. Reflect.preventExtensions maakt juist het Booleaanse resultaat beschikbaar en weigert primitieve waarden.

Een Proxy kan de bewerking onderscheppen met zijn preventExtensions-trap. De trap kan de bewerking weigeren door false terug te geven, maar succes melden terwijl het doelobject nog uitbreidbaar is, veroorzaakt een TypeError. In het voorbeeld laat Reflect.set zien dat het toevoegen van een eigenschap mislukt, zonder afhankelijk te zijn van de strict-modus.

Voorbeelden

const item = { count: 1 };
console.log(Reflect.preventExtensions(item));
console.log(Reflect.isExtensible(item));
console.log(Reflect.set(item, "extra", 10));
item.count = 2;
console.log(item.count);
console.log(Reflect.deleteProperty(item, "count"));
console.log(Reflect.has(item, "count"));

Resultaat

true
false
false
2
true
false

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