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