KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.isSealed — controleren of een object verzegeld is

Object.isSealed(value) controleert of een object niet-uitbreidbaar is en al zijn eigen eigenschappen niet-configureerbaar zijn. Dit betekent niet dat waarden onveranderlijk zijn of dat geneste objecten verzegeld zijn.

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.isSealed(value)

Object.isSealed(value) geeft true terug wanneer het object niet-uitbreidbaar is en elke eigen eigenschap configurable: false heeft. De controle omvat niet-enumerabele eigenschappen en Symbol-sleutels, maar geen overgeërfde eigenschappen. De methode inspecteert de toestand; anders dan Object.seal legt ze deze beperkingen niet op.

Verzegeling verhindert het toevoegen en verwijderen van eigen eigenschappen en wijzigingen die door hun niet-configureerbaarheid verboden zijn. Verzegeling op zich wijzigt het attribuut writable niet. Bij een gewoon object kun je nog steeds een nieuwe waarde toewijzen aan een schrijfbare eigen data-eigenschap. Bij exotische objecten garandeert writable: true echter niet dat een toewijzing slaagt. Zo rapporteert een verzegeld modulenaamruimteobject writable: true voor zijn geëxporteerde bindingen, maar weigert het toewijzingen aan die bindingen. Object.isFrozen vereist daarnaast dat eigen data-eigenschappen niet schrijfbaar zijn. Geen van beide controles is recursief.

Object.preventExtensions alleen is doorgaans onvoldoende als er configureerbare eigenschappen overblijven. Een leeg, niet-uitbreidbaar object is echter wel verzegeld. In het huidige ECMAScript geven primitieve argumenten, waaronder null en undefined, true terug; dat betekent niet dat het objecten zijn.

Bij een Proxy kan de controle traps aanroepen en een uitzondering veroorzaken, dus is het niet altijd een inspectie zonder neveneffecten. Dit is een ECMAScript-taal-API, geen browser-Web-API; de taalspecificatie is geen browsercompatibiliteitstabel.

Voorbeelden

const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));

Resultaat

false
true
false
2
false
true
true

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