handler.isExtensible()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

Die handler.isExtensible() Methode ist eine Trap für die [[IsExtensible]] objektinterne Methode, welche von Operationen wie Object.isExtensible() verwendet wird.

Probieren Sie es aus

const monster1 = {
  canEvolve: true,
};

const handler1 = {
  isExtensible(target) {
    return Reflect.isExtensible(target);
  },
  preventExtensions(target) {
    target.canEvolve = false;
    return Reflect.preventExtensions(target);
  },
};

const proxy1 = new Proxy(monster1, handler1);

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

console.log(monster1.canEvolve);
// Expected output: true

Object.preventExtensions(proxy1);

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

console.log(monster1.canEvolve);
// Expected output: false

Syntax

new Proxy(target, {
  isExtensible(target) {
  }
})

Parameter

Der folgende Parameter wird an die isExtensible() Methode übergeben. this ist an den Handler gebunden.

target: Das Zielobjekt.

Rückgabewert

Die isExtensible() Methode muss einen Boolean zurückgeben, der angibt, ob das Zielobjekt erweiterbar ist oder nicht. Andere Werte werden in boolesche Werte umgewandelt.

Beschreibung

Interceptions

Diese Trap kann folgende Operationen abfangen:

Oder jede andere Operation, die die [[IsExtensible]] interne Methode aufruft.

Invarianten

Die [[IsExtensible]] interne Methode des Proxys wirft einen TypeError, wenn die Definition des Handlers gegen eine der folgenden Invarianten verstößt:

Das Ergebnis muss dasselbe sein wie Reflect.isExtensible() auf dem Zielobjekt.

Beispiele

Abfangen von isExtensible

Der folgende Code fängt Object.isExtensible() ab.

const p = new Proxy(
  {},
  {
    isExtensible(target) {
      console.log("called");
      return true;
    },
  },
);

console.log(Object.isExtensible(p));
// "called"
// true

Der folgende Code verletzt die Invariante.

const p = new Proxy(
  {},
  {
    isExtensible(target) {
      return false;
    },
  },
);

Object.isExtensible(p); // TypeError is thrown

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-isextensible