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

CKTIS / JavaScript

Object.seal — запечатване на обект

Object.seal предотвратява добавянето и изтриването на собствени свойства на обект, но не го прави неизменяем. В обикновен обект на съществуващите записваеми свойства с данни все още могат да се задават нови стойности, а вложените обекти не се запечатват автоматично.

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

Синтаксис

Object.seal(obj)

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

Запечатването не означава неизменяемост. В обикновен обект на съществуващите свойства с данни и writable: true все още могат да се задават нови стойности, а writable може да се промени от true на false, но не и обратно. Дескрипторите на свойствата, които съответстват на експортите на запечатан обект на пространство от имена на модул, показват writable: true, но обектът отхвърля както присвояванията на стойности на тези свойства, така и опитите техният атрибут writable да се промени на false. Съществуващите сетери могат да продължат да работят. Операцията е повърхностна: вложените обекти не се запечатват автоматично.

Object.preventExtensions предотвратява добавянето на собствени свойства, но сам по себе си не прави съществуващите свойства неконфигурируеми. В обикновен обект Object.freeze допълнително задава writable: false за собствените свойства с данни; и тази операция е повърхностна. Проверете състоянието на запечатване с Object.isSealed.

В строг режим недопустимо присвояване на ново свойство или изтриване на съществуващо свойство с delete предизвиква TypeError; извън строг режим тези операции обикновено се провалят без изключение. Object.seal може да предизвика изключение, ако запечатването не успее, например при някои Proxy обекти. В съвременния ECMAScript аргумент, който не е обект, се връща без промяна.

Примери

"use strict";

const settings = { volume: 2, theme: { dark: false } };
const result = Object.seal(settings);
settings.volume = 3;
settings.theme.dark = true;

console.log(result === settings);
console.log(Object.isSealed(settings));
console.log(settings.volume, settings.theme.dark);

try {
  settings.extra = 1;
} catch (error) {
  console.log(error instanceof TypeError);
}

console.log(Reflect.deleteProperty(settings, "volume"));
console.log(Object.isSealed(settings.theme));

Резултат

true
true
3 true
true
false
false

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

Източници