KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.seal — een object verzegelen

Object.seal voorkomt dat eigen eigenschappen van een object worden toegevoegd of verwijderd, maar maakt het object niet onveranderlijk. Bij gewone objecten kunnen bestaande schrijfbare data-eigenschappen nog nieuwe waarden krijgen. Geneste objecten worden niet automatisch verzegeld.

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.seal(obj)

Object.seal(obj) wijzigt het opgegeven object en retourneert datzelfde object, zonder een kopie te maken. De methode voorkomt uitbreiding en stelt voor alle eigen eigenschappen configurable: false in, ook voor niet-enumerabele eigenschappen en eigenschappen met een Symbol-sleutel. Daarna kunnen eigen eigenschappen niet meer worden toegevoegd of verwijderd, kan hun enumerability niet worden gewijzigd en kunnen data-eigenschappen niet worden omgezet in accessors of omgekeerd.

Verzegelen betekent niet dat het object onveranderlijk is. Bij een gewoon object kunnen bestaande data-eigenschappen met writable: true nog steeds nieuwe waarden krijgen. Je kunt writable wijzigen van true naar false, maar niet andersom. De descriptors van de exporteigenschappen van een verzegeld module-namespaceobject geven writable: true aan, maar het object weigert zowel toewijzingen aan die eigenschappen als pogingen om hun attribuut writable op false te zetten. Bestaande setters kunnen blijven werken. De bewerking is oppervlakkig: geneste objecten worden niet automatisch verzegeld.

Object.preventExtensions voorkomt het toevoegen van eigen eigenschappen, maar laat het attribuut configurable van bestaande eigenschappen ongewijzigd. Bij een gewoon object stelt Object.freeze daarnaast writable: false in voor eigen data-eigenschappen; ook deze bewerking werkt oppervlakkig. Controleer de verzegelingsstatus met Object.isSealed.

In strict mode veroorzaakt een niet-toegestane toewijzing aan een nieuwe eigenschap of het verwijderen van een bestaande eigenschap met delete een TypeError; buiten strict mode mislukken zulke bewerkingen doorgaans zonder uitzondering. Object.seal kan een uitzondering veroorzaken als het verzegelen mislukt, bijvoorbeeld bij sommige Proxy-objecten. In modern ECMAScript wordt een argument dat geen object is ongewijzigd teruggegeven.

Voorbeelden

"use strict";

const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;

console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);

try {
  settings.extra = 1;
} catch (error) {
  console.log(error instanceof TypeError);
}

console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));

Resultaat

true
true
3 true
true
false
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