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 es neue Eigenschaften erhalten kann).

Probieren Sie es aus

const object1 = {};

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

Object.preventExtensions(object1);

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

Syntax

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.

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

Beispiele

Verwendung von Object.isExtensible

// 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

Argument, das kein Objekt ist

In ES5 führt diese Methode zu einem TypeError, wenn das Argument kein Objekt (ein primitiver Wert) ist. In ES2015 wird false zurückgegeben, ohne dass ein Fehler auftritt, wenn ein Argument, das kein Objekt ist, übergeben wird, da primitive Werte per Definition unveränderlich sind.

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

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

Spezifikationen

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