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.