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
const object = {};
console.log(Object.isExtensible(object));
// Expected output: true
Object.preventExtensions(object);
console.log(Object.isExtensible(object));
// Expected output: false
Syntax
Object.isExtensible(obj)
Parameter
obj-
Das zu überprüfende Objekt.
Rückgabewert
Ein Boolean, der angibt, ob das gegebene Objekt erweiterbar ist oder nicht.
Beschreibung
Objekte sind standardmäßig erweiterbar: Sie können neue Eigenschaften enthalten, 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 verursacht es einen TypeError, wenn das Argument dieser Methode kein Objekt (eine Primitive) ist. In ES2015 wird false ohne Fehler zurückgegeben, wenn ein Nicht-Objekt-Argument übergeben wird, da Primitive 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 |