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.