handler.has()

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

target

Das Zielobjekt.

property

Ein String oder Symbol, der den Eigenschaftsnamen darstellt.

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

Diese Trap kann folgende Operationen abfangen:

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

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

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

• Eine Eigenschaft kann nicht als nicht existent gemeldet werden, wenn sie als nicht konfigurierbares eigenes Attribut des Zielobjekts existiert. Das heißt, wenn Reflect.getOwnPropertyDescriptor() configurable: false für die Eigenschaft auf target zurückgibt, muss die Trap 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() false auf target zurückgibt und Reflect.getOwnPropertyDescriptor() einen Eigenschaftsbeschreiber für die Eigenschaft auf target zurückgibt, muss die Trap true zurückgeben.

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

• Proxy
• Proxy() Konstruktor
• in
• Reflect.has()