handler.get()

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.get() ist eine Trap für die [[Get]] interne Objektmethode, die von Operationen wie Property-Accessoren verwendet wird.

Probieren Sie es aus

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

const handler1 = {
  get(target, prop, receiver) {
    if (prop === "secret") {
      return `${target.secret.substring(0, 4)} ... shhhh!`;
    }
    return Reflect.get(...arguments);
  },
};

const proxy1 = new Proxy(monster1, handler1);

console.log(proxy1.eyeCount);
// Expected output: 4

console.log(proxy1.secret);
// Expected output: "easi ... shhhh!"

Syntax

new Proxy(target, {
  get(target, property, receiver) {
  }
})

Parameter

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

target: Das Zielobjekt.
property: Ein String oder ein Symbol, das den Property-Namen darstellt.
receiver: Der this-Wert für Getter; siehe Reflect.get(). Dies ist normalerweise entweder der Proxy selbst oder ein Objekt, das vom Proxy erbt.

Rückgabewert

Die get()-Methode kann einen beliebigen Wert zurückgeben, der den Eigenschaftswert darstellt.

Beschreibung

Abfangaktionen

Diese Trap kann die folgenden Operationen abfangen:

Property-Zugriff: proxy[foo] und proxy.bar
Reflect.get()

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

Invarianten

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

Der für eine Eigenschaft gemeldete Wert muss identisch mit dem Wert der entsprechenden Zielobjekteigenschaft sein, wenn die Zielobjekteigenschaft eine nicht veränderbare, nicht konfigurierbare eigene Daten-Eigenschaft ist. Das heißt, wenn Reflect.getOwnPropertyDescriptor() configurable: false, writable: false für die Eigenschaft auf target zurückgibt, muss die Trap denselben Wert wie das value-Attribut im Eigenschafts-Deskriptor des target zurückgeben.
Der für eine Eigenschaft gemeldete Wert muss undefined sein, wenn die entsprechende Zielobjekteigenschaft eine nicht konfigurierbare eigene Accessor-Eigenschaft ist, die einen undefinierten Getter hat. Das heißt, wenn Reflect.getOwnPropertyDescriptor() configurable: false, get: undefined für die Eigenschaft auf target zurückgibt, muss die Trap undefined zurückgeben.

Beispiele

Trap zum Abrufen eines Eigenschaftswertes

Der folgende Code fängt den Abruf eines Eigenschaftswertes ab.

const p = new Proxy(
  {},
  {
    get(target, property, receiver) {
      console.log(`called: ${property}`);
      return 10;
    },
  },
);

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

Der folgende Code verletzt eine Invariante.

const obj = {};
Object.defineProperty(obj, "a", {
  configurable: false,
  enumerable: false,
  value: 10,
  writable: false,
});

const p = new Proxy(obj, {
  get(target, property) {
    return 20;
  },
});

p.a; // TypeError is thrown

Spezifikationen

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