База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.freeze: най-горно ниво без разширяване и запис

Object.freeze спира разширяването и преконфигурирането на собствените свойства и прави собствените data свойства non-writable.

Версия: ECMAScript 5 onward; primitive-return behavior since ECMAScript 2015; example target: Node.js 24.22.2

Синтаксис

Object.freeze(value)

Object.freeze(value) връща примитив без промяна. За обект изпълнява SetIntegrityLevel с ниво frozen: предотвратява нови свойства, задава configurable: false на всички собствени свойства и също writable: false на собствените data свойства. Връща същия обект.

Accessor свойство запазва getter и setter; премахва се само configurable възможността му. Замразяването е плитко: вложени обекти, private elements и вътрешните данни на Map и Set не стават автоматично immutable. Setter все още може да променя вложено или външно състояние. Deep immutability изисква контролиран, безопасен при цикли обход на графа.

Методът съществува от ECMAScript 5; връщането на не-обектни стойности вместо грешка важи от ECMAScript 2015. Неуспех на PreventExtensions или нарушение на Proxy invariants хвърля TypeError. Typed arrays с елементи не могат да бъдат замразени и също хвърлят TypeError; typed array с нулева дължина може.

Примери

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); }

Резултат

true true
false false function false
true true
7
TypeError

Примерът потвърждава data и accessor атрибути, плитко замразяване, примитив и грешката за typed array.

Източници