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 Methode handler.isExtensible() ist eine Trap für die interne Methode [[IsExtensible]] des Objekts, die durch 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

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

Parameter

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

target

Das Zielobjekt.

Rückgabewert

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

Beschreibung

Abfangvorgänge

Diese Trap kann folgende Operationen abfangen:

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

Invarianten

Die interne Methode [[IsExtensible]] des Proxys löst einen TypeError aus, wenn die Definition des Handlers eine der folgenden Invarianten verletzt:

Beispiele

Abfangen von isExtensible

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

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

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

Der folgende Code verletzt die Invariante.

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

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

Spezifikationen

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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
isExtensible

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch