JavaScript Object.isSealed()

// by default, objects are not sealed
let empty = {};
console.log(Object.isSealed(empty));

// Output: false

isSealed() syntax

The syntax of the isSealed() method is:

Object.isSealed(obj)

The isSealed() method, being a static method, is called using the Object class name.

isSealed() Parameters

The isSealed() method takes in:

• obj - the object which should be checked

isSealed() Return Value

The isSealed() method returns a Boolean indicating whether the given object is sealed or not. It returns:

• true - if obj is sealed
• false - if obj is not sealed

Example 1: JavaScript Object.isSealed() With Empty Object

// objects are not sealed by default
let empty = {};

// check if empty object is sealed
console.log(Object.isSealed(empty)); 

// Output: false

// non-extensible empty objects are sealed
Object.preventExtensions(empty);

// check if empty object is sealed
console.log(Object.isSealed(empty)); 

// Output: true

Example 2: isSealed() With Non-Empty Object

// create a non-empty object
let obj = { value: "A B C" };

// non-empty objects are sealed only when
// all its properties are non-configurable
Object.preventExtensions(obj);

// check if obj is sealed
console.log(Object.isSealed(obj));

// Output: false

// make all properties non-configurable
Object.defineProperty(obj, "value", { configurable: false });

// check if obj is sealed
console.log(Object.isSealed(obj)); 

// Output: true

As can be seen from the example above, simply using the preventExtensions() method won't guarantee that the object will be sealed. To seal an object, we also need to ensure that all its properties are non-configurable.

Hence, we get false as an output when using the isSealed() method on obj, even though we've already used preventExtensions() on it.

Therefore, we have used the defineProperty() method on obj to set the configurable flag of its property to false. This ensures that obj is finally sealed.

Example 3: isSealed() With the seal() Method

let obj2 = { a: 1, b: 2, c: 3 };

// seal the obj2 object
// using the seal() method
Object.seal(obj2);

// check if obj2 is sealed
console.log(Object.isSealed(obj2)); 

// Output: true

Using the seal() method always ensures that the object is sealed. Hence, we get true as an output after using the seal() method with the obj2.

• JavaScript Object.seal()