handler.getPrototypeOf()

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.getPrototypeOf()-Methode ist eine Trap für die [[GetPrototypeOf]] Interne Methode des Objekts, die bei Operationen wie Object.getPrototypeOf() verwendet wird.

Probieren Sie es aus

const monster1 = {
  eyeCount: 4,
};

const monsterPrototype = {
  eyeCount: 2,
};

const handler = {
  getPrototypeOf(target) {
    return monsterPrototype;
  },
};

const proxy1 = new Proxy(monster1, handler);

console.log(Object.getPrototypeOf(proxy1) === monsterPrototype);
// Expected output: true

console.log(Object.getPrototypeOf(proxy1).eyeCount);
// Expected output: 2

Syntax

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

Parameter

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

target: Das Zielobjekt.

Rückgabewert

Die Methode getPrototypeOf() muss ein Objekt oder null zurückgeben, das das Prototyp-Objekt des Zielobjekts darstellt.

Beschreibung

Abfangen von Operationen

Diese Trap kann die folgenden Operationen abfangen:

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

Invarianten

Die [[GetPrototypeOf]]-Interne Methode des Proxies löst einen TypeError aus, wenn die Handler-Definition eine der folgenden Invarianten verletzt:

Das Ergebnis muss entweder ein Object oder null sein.
Wenn das Zielobjekt nicht erweiterbar ist (d.h. Reflect.isExtensible() gibt false für target zurück), muss das Ergebnis dasselbe sein wie das Ergebnis von Reflect.getPrototypeOf(target).

Beispiele

Grundlegende Verwendung

const obj = {};
const proto = {};
const handler = {
  getPrototypeOf(target) {
    console.log(target === obj); // true
    console.log(this === handler); // true
    return proto;
  },
};

const p = new Proxy(obj, handler);
console.log(Object.getPrototypeOf(p) === proto); // true

Fünf Wege, die Trap getPrototypeOf auszulösen

const obj = {};
const p = new Proxy(obj, {
  getPrototypeOf(target) {
    return Array.prototype;
  },
});
console.log(
  Object.getPrototypeOf(p) === Array.prototype, // true
  Reflect.getPrototypeOf(p) === Array.prototype, // true
  p.__proto__ === Array.prototype, // true
  Array.prototype.isPrototypeOf(p), // true
  p instanceof Array, // true
);

Zwei Arten von Ausnahmen

const obj = {};
const p = new Proxy(obj, {
  getPrototypeOf(target) {
    return "foo";
  },
});
Object.getPrototypeOf(p); // TypeError: "foo" is not an object or null

const obj2 = Object.preventExtensions({});
const p2 = new Proxy(obj2, {
  getPrototypeOf(target) {
    return {};
  },
});
Object.getPrototypeOf(p2); // TypeError: expected same prototype value

Spezifikationen

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