CKTIS / JavaScript
Object.preventExtensions — nieuwe eigenschappen voorkomen
Object.preventExtensions(obj) voorkomt onomkeerbaar dat eigen eigenschappen aan een object worden toegevoegd en retourneert datzelfde object. Bestaande waarden en geneste objecten worden er niet door bevroren.
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
Object.preventExtensions(obj)Object.preventExtensions(obj) maakt een object niet-uitbreidbaar: er kunnen geen nieuwe eigen eigenschappen worden toegevoegd, ook geen eigenschappen met symbol-sleutels. De methode wijzigt het opgegeven object en retourneert dezelfde referentie, geen kopie. Gebruik Object.isExtensible(obj) om de status te controleren. De bewerking kan niet ongedaan worden gemaakt.
Bij een gewoon object behouden bestaande eigenschappen hun descriptors: aan schrijfbare eigenschappen kunnen nog steeds waarden worden toegewezen en configureerbare eigenschappen kunnen nog steeds worden verwijderd. Een verwijderde eigenschap kan niet opnieuw worden toegevoegd. Het prototype mag ook niet door een ander worden vervangen; het huidige prototype opgeven blijft toegestaan.
Een getypeerde array met een vaste lengte die een ArrayBuffer met een niet-wijzigbare grootte gebruikt, kan niet-uitbreidbaar worden gemaakt. De bestaande geïndexeerde elementen kunnen echter niet worden verwijderd, ook al vermelden hun descriptors configurable: true.
Een toewijzing die een nieuwe eigen eigenschap zou aanmaken, veroorzaakt in de strikte modus een TypeError en wordt daarbuiten meestal genegeerd. Object.defineProperty veroorzaakt een TypeError wanneer daarmee een eigenschap wordt toegevoegd, ongeacht de modus. De methode zelf veroorzaakt ook een TypeError als de interne bewerking weigert uitbreiding te voorkomen, bijvoorbeeld door een Proxy-val die false retourneert. In het huidige ECMAScript worden primitieve argumenten, waaronder null en undefined, ongewijzigd geretourneerd.
Object.seal biedt meer bescherming: het zet configurable voor alle eigen eigenschappen op false, zodat ze niet kunnen worden verwijderd. Bij een verzegeld gewoon object kan het attribuut writable van een schrijfbare data-eigenschap nog steeds van true naar false worden gewijzigd. Bij een verzegeld naamruimteobject van een module vermelden de descriptors van de eigenschappen die overeenkomen met de geëxporteerde bindingen writable: true, maar het object staat niet toe dat dit attribuut op false wordt gezet. Bij een gewoon object zet Object.freeze daarnaast writable voor alle eigen data-eigenschappen op false. Bij een naamruimteobject van een module veroorzaakt Object.freeze een TypeError wanneer het probeert writable op false te zetten voor een eigenschap die overeenkomt met een geëxporteerde binding. Als die binding nog niet is geïnitialiseerd, kan het opvragen van de descriptor van de eigenschap al vóór die poging een ReferenceError veroorzaken. Geen van deze bewerkingen werkt recursief door op geneste objecten. Dit is een API van de ECMAScript-taal, geen browser-Web-API; de standaard alleen bewijst niet dat een bepaalde browser dit ondersteunt.
Voorbeelden
"use strict";
const item = { count: 1, temporary: true };
const result = Object.preventExtensions(item);
console.log(result === item);
console.log(Object.isExtensible(item));
item.count = 2;
console.log(item.count);
console.log(delete item.temporary);
try {
item.extra = 3;
} catch (error) {
console.log(error.name);
}
console.log(Object.hasOwn(item, "extra"));Resultaat
true false 2 true TypeError 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.