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

CKTIS / JavaScript

Object.isSealed — проверка дали даден обект е запечатан

Object.isSealed(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.isSealed(value)

Object.isSealed(value) връща true, когато обектът не може да се разширява и всяко негово собствено свойство има configurable: false. Проверката включва и неизброимите свойства и ключовете Symbol, но не и наследените свойства. Тя проверява състоянието; за разлика от Object.seal, не налага тези ограничения.

Запечатването предотвратява добавянето и изтриването на собствени свойства, както и промените, забранени от тяхната неконфигурируемост. Самото запечатване не променя атрибута writable. При обикновен обект на записваемо собствено свойство за данни все още може да се присвои нова стойност. При екзотичните обекти обаче writable: true не гарантира, че присвояването ще успее. Например запечатан обект, който представлява пространството от имена на модул, отчита writable: true за експортираните си обвързвания, но отхвърля присвояването на стойности към тях. Object.isFrozen допълнително изисква собствените свойства за данни да не са записваеми. Нито една от двете проверки не е рекурсивна.

Само Object.preventExtensions обикновено не е достатъчен, ако останат конфигурируеми свойства. Празен обект, който не може да се разширява, обаче е запечатан. В съвременния ECMAScript примитивните аргументи, включително null и undefined, връщат true; това не означава, че са обекти.

При Proxy проверката може да извика капани и да хвърли изключение, така че не винаги е проверка без странични ефекти. Това е API на езика ECMAScript, а не браузърно Web API; спецификацията на езика не е таблица за съвместимост на браузърите.

Примери

const item = { count: 1, nested: { active: true } };
console.log(Object.isSealed(item));
Object.seal(item);
item.count = 2;
console.log(Object.isSealed(item));
console.log(Object.isFrozen(item));
console.log(item.count);
console.log(Object.isSealed(item.nested));
console.log(Object.isSealed(Object.preventExtensions({})));
console.log(Object.isSealed(null));

Резултат

false
true
false
2
false
true
true

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

Източници