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 Object.isExtensible()-statische Methode 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

js
Object.isExtensible(obj)

Parameter

obj

Das Objekt, das überprüft werden soll.

Rückgabewert

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

Beschreibung

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

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 führt ein Argument, das kein Objekt (ein Primitivwert) ist, bei dieser Methode zu einem TypeError. In ES2015 gibt die Methode false zurück, ohne einen Fehler auszulösen, wenn ein Nicht-Objekt-Argument übergeben wird, da Primitivwerte per Definition unveränderlich sind.

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

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch