handler.has()

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.has()-Methode ist eine Falle für die [[HasProperty]]-interne Objektmethode, die von Operationen wie dem in-Operator verwendet wird.

Probieren Sie es aus

const handler1 = {
  has(target, key) {
    if (key[0] === "_") {
      return false;
    }
    return key in target;
  },
};

const monster1 = {
  _secret: "easily scared",
  eyeCount: 4,
};

const proxy1 = new Proxy(monster1, handler1);
console.log("eyeCount" in proxy1);
// Expected output: true

console.log("_secret" in proxy1);
// Expected output: false

console.log("_secret" in monster1);
// Expected output: true

Syntax

new Proxy(target, {
  has(target, property) {
  }
})

Parameter

Die folgenden Parameter werden an die Methode has() übergeben. this ist an den Handler gebunden.

target: Das Zielobjekt.
property: Ein String oder ein Symbol, der den Namen der Eigenschaft darstellt.

Rückgabewert

Die has()-Methode muss einen Boolean zurückgeben, der angibt, ob die Eigenschaft existiert oder nicht. Andere Werte werden in Booleans umgewandelt.

Beschreibung

Abfangbare Operationen

Diese Falle kann folgende Operationen abfangen:

Der in-Operator: foo in proxy
with-Überprüfung: with(proxy) { (foo); }
Reflect.has()

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

Invarianten

Die [[HasProperty]]-interne Methode des Proxys wirft einen TypeError, wenn die Handler-Definition eine der folgenden Invarianten verletzt:

Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als nicht-konfigurierbare eigene Eigenschaft des Zielobjekts existiert. Das heißt, wenn Reflect.getOwnPropertyDescriptor() configurable: false für die Eigenschaft auf target zurückgibt, muss die Falle true zurückgeben.
Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als eigene Eigenschaft des Zielobjekts existiert und das Zielobjekt nicht erweiterbar ist. Das heißt, wenn Reflect.isExtensible() auf target false zurückgibt, und Reflect.getOwnPropertyDescriptor() eine Eigenschaftsbeschreibung für die Eigenschaft auf target liefert, muss die Falle true zurückgeben.

Beispiele

Abfangen des in-Operators

Der folgende Code fängt den in-Operator ab.

const p = new Proxy(
  {},
  {
    has(target, prop) {
      console.log(`called: ${prop}`);
      return true;
    },
  },
);

console.log("a" in p);
// "called: a"
// true

Der folgende Code verletzt eine Invariante.

const obj = { a: 10 };
Object.preventExtensions(obj);

const p = new Proxy(obj, {
  has(target, prop) {
    return false;
  },
});

"a" in p; // TypeError is thrown

Spezifikationen

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