KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Object.freeze: bovenste niveau niet uitbreidbaar en niet schrijfbaar

Object.freeze voorkomt uitbreiding en herconfiguratie van eigen eigenschappen en maakt eigen data-eigenschappen niet-schrijfbaar.

Versie: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2

Syntax

Object.freeze(value)

Object.freeze(value) retourneert een primitieve waarde ongewijzigd. Voor een object voert het SetIntegrityLevel op niveau frozen uit: het voorkomt nieuwe eigenschappen, zet configurable: false op elke eigen eigenschap en ook writable: false op eigen data-eigenschappen. Het retourneert hetzelfde object.

Een accessoreigenschap behoudt getter en setter; alleen configureerbaarheid verdwijnt. Bevriezen is oppervlakkig: geneste objecten, privé-elementen en interne gegevens van Map en Set worden niet automatisch onveranderlijk. Een setter kan nog geneste of externe toestand wijzigen. Diepe onveranderlijkheid vereist gecontroleerde, cyclusveilige doorloop van de gegevensgraaf.

De methode bestaat sinds ECMAScript 5; niet-objecten retourneren in plaats van werpen geldt sinds ECMAScript 2015. Mislukte PreventExtensions of een Proxy-invariantschending werpt TypeError. Typed arrays met elementen kunnen niet worden bevroren en werpen ook TypeError; een typed array met lengte nul kan wel worden bevroren.

Voorbeelden

const config = {
  nested: { enabled: false },
  get status() { return this.nested.enabled; },
  set status(value) { this.nested.enabled = value; }
};
const same = Object.freeze(config);
const nested = Object.getOwnPropertyDescriptor(config, "nested");
const status = Object.getOwnPropertyDescriptor(config, "status");
console.log(same === config, Object.isFrozen(config));
console.log(nested.writable, nested.configurable, typeof status.set, status.configurable);
config.status = true;
console.log(config.nested.enabled, config.status);
console.log(Object.freeze(7));
try { Object.freeze(new Uint8Array([1])); }
catch (error) { console.log(error.name); }

Resultaat

true true
false false function false
true true
7
TypeError

Het voorbeeld bevestigt data- en accessorattributen, oppervlakkig bevriezen, een primitief en de typed-arrayfout.

Bronnen