Object.isSealed()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die statische Methode Object.isSealed() bestimmt, ob ein Objekt versiegelt ist.

Probieren Sie es aus

const object1 = {
  property1: 42,
};

console.log(Object.isSealed(object1));
// Expected output: false

Object.seal(object1);

console.log(Object.isSealed(object1));
// Expected output: true

Syntax

js
Object.isSealed(obj)

Parameter

obj

Das zu überprüfende Objekt.

Rückgabewert

Ein Boolean, der angibt, ob das gegebene Objekt versiegelt ist oder nicht.

Beschreibung

Gibt true zurück, wenn das Objekt versiegelt ist, andernfalls false. Ein Objekt ist versiegelt, wenn es nicht erweiterbar ist und wenn alle seine Eigenschaften nicht konfigurierbar und daher nicht entfernbar sind (aber nicht notwendigerweise nicht beschreibbar).

Beispiele

Verwendung von Object.isSealed

js
// Objects aren't sealed by default.
const empty = {};
Object.isSealed(empty); // false

// If you make an empty object non-extensible,
// it is vacuously sealed.
Object.preventExtensions(empty);
Object.isSealed(empty); // true

// The same is not true of a non-empty object,
// unless its properties are all non-configurable.
const hasProp = { fee: "fie foe fum" };
Object.preventExtensions(hasProp);
Object.isSealed(hasProp); // false

// But make them all non-configurable
// and the object becomes sealed.
Object.defineProperty(hasProp, "fee", {
  configurable: false,
});
Object.isSealed(hasProp); // true

// The easiest way to seal an object, of course,
// is Object.seal.
const sealed = {};
Object.seal(sealed);
Object.isSealed(sealed); // true

// A sealed object is, by definition, non-extensible.
Object.isExtensible(sealed); // false

// A sealed object might be frozen,
// but it doesn't have to be.
Object.isFrozen(sealed); // true
// (all properties also non-writable)

const s2 = Object.seal({ p: 3 });
Object.isFrozen(s2); // false
// ('p' is still writable)

const s3 = Object.seal({
  get p() {
    return 0;
  },
});
Object.isFrozen(s3); // true
// (only configurability matters for accessor properties)

Argument ist kein Objekt

In ES5 führt das Übergeben eines nicht-Objekts (einer primitiven Datenstruktur) zu einem TypeError. In ES2015 wird es true zurückgeben, ohne Fehler zu verursachen, wenn ein nicht-Objekt-Argument übergeben wird, da primitive Datenstrukturen per Definition unveränderlich sind.

js
Object.isSealed(1);
// TypeError: 1 is not an object (ES5 code)

Object.isSealed(1);
// true                          (ES2015 code)

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-object.issealed

Browser-Kompatibilität

Siehe auch