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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.