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

CKTIS / JavaScript

Object.isFrozen — проверка дали обектът е замразен

Object.isFrozen(value) проверява дали обектът не може да се разширява, собствените му свойства не могат да се конфигурират и свойствата му с данни не могат да се записват. Методът не замразява обекта и не проверява рекурсивно вложените обекти.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Object.isFrozen(value)

Object.isFrozen(value) е статичен метод, който връща true, когато към обекта не могат да се добавят собствени свойства, всички негови собствени свойства имат configurable: false, а собствените му свойства с данни имат и writable: false. Включени са символни ключове и неизброими свойства, но не и наследените свойства.

Методът проверява състоянието, вместо да го променя; за замразяване на обект използвайте Object.freeze. Само Object.seal не е достатъчен, ако останат записваеми свойства с данни. Празен обект обаче е замразен след Object.preventExtensions, защото няма свойства, които да нарушават останалите условия.

Резултат true не означава дълбока неизменност. Обектите, съхранени като стойности на свойства, все още могат да се променят. Свойствата-аксесори могат да запазят setter-и, а getter-ите могат да връщат променливи резултати; проверката не изисква премахването им и не извиква getter-ите на обикновен обект.

За примитивни стойности, включително null и undefined, текущата спецификация връща true. При Proxy проверката може да задейства капани и да хвърли изключение, така че невинаги е операция без странични ефекти.

Примери

const settings = { theme: { dark: false } };
console.log(Object.isFrozen(settings));
Object.freeze(settings);
console.log(Object.isFrozen(settings));
console.log(Object.isFrozen(settings.theme));
settings.theme.dark = true;
console.log(settings.theme.dark);
console.log(Object.isFrozen(Object.preventExtensions({})));
console.log(Object.isFrozen(null));

Резултат

false
true
false
true
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници