Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Object.freeze: najwyższy poziom bez rozszerzania i zapisu

Object.freeze blokuje rozszerzanie obiektu oraz rekonfigurację jego własnych właściwości, a własne właściwości danych czyni niezapisywalnymi.

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

Składnia

Object.freeze(value)

Object.freeze(value) zwraca wartość pierwotną bez zmian. Dla obiektu wykonuje SetIntegrityLevel z poziomem frozen: zapobiega dodawaniu właściwości, ustawia configurable: false na wszystkich własnych właściwościach, a na właściwościach danych także writable: false. Zwraca ten sam obiekt.

Właściwość akcesora zachowuje getter i setter; jedynie staje się niekonfigurowalna. Zamrożenie jest płytkie: zagnieżdżone obiekty, elementy prywatne oraz wewnętrzne dane Map i Set nie stają się automatycznie niezmienne. Setter może nadal zmieniać zagnieżdżony lub zewnętrzny stan. Do głębokiej niezmienności potrzebne jest kontrolowane, cykloodporne przejście po grafie danych.

Metoda istnieje od ECMAScript 5; zwracanie nieobiektowych wartości zamiast błędu obowiązuje od ECMAScript 2015. Niepowodzenie PreventExtensions albo naruszenie niezmienników przez Proxy powoduje TypeError. Typowanych tablic z elementami nie można zamrozić i również rzucają TypeError, natomiast typowana tablica o zerowej długości może zostać zamrożona.

Przykłady

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

Wynik

true true
false false function false
true true
7
TypeError

Przykład potwierdza atrybuty danych i akcesora, płytkość zamrożenia, obsługę liczby i błąd typowanej tablicy.

Źródła