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