Object.isExtensible()

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.isExtensible() bestimmt, ob ein Objekt erweiterbar ist (ob ihm neue Eigenschaften hinzugefügt werden können).

Probieren Sie es aus

Syntax

js
Object.isExtensible(obj)

Parameter

obj

Das Objekt, das überprüft werden soll.

Rückgabewert

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

Beschreibung

Objekte sind standardmäßig erweiterbar: ihnen können neue Eigenschaften hinzugefügt werden, und ihr [[Prototype]] kann neu zugewiesen werden. Ein Objekt kann als nicht erweiterbar markiert werden, indem eine der Methoden Object.preventExtensions(), Object.seal(), Object.freeze() oder Reflect.preventExtensions() verwendet wird.

Beispiele

Verwendung von Object.isExtensible

js
// New objects are extensible.
const empty = {};
Object.isExtensible(empty); // true

// They can be made un-extensible
Object.preventExtensions(empty);
Object.isExtensible(empty); // false

// Sealed objects are by definition non-extensible.
const sealed = Object.seal({});
Object.isExtensible(sealed); // false

// Frozen objects are also by definition non-extensible.
const frozen = Object.freeze({});
Object.isExtensible(frozen); // false

Nicht-Objekt-Argument

In ES5 verursacht die Übergabe eines nicht-Objekt-Arguments (eines Primitivwertes) an diese Methode einen TypeError. In ES2015 wird false zurückgegeben, ohne dass ein Fehler auftritt, wenn ein nicht-Objekt-Argument übergeben wird, da Primitive definitionsgemäß unveränderlich sind.

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

Object.isExtensible(1);
// false                         (ES2015 code)

Spezifikationen

Specification
ECMAScript Language Specification
# sec-object.isextensible

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch