handler.construct()

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.construct() Methode ist eine Falle für die [[Construct]] objektinterne Methode, die von Operationen wie dem new Operator verwendet wird. Damit die new-Operation auf dem resultierenden Proxy-Objekt gültig ist, muss das Ziel, das verwendet wird, um den Proxy zu initialisieren, selbst ein gültiger Konstruktor sein.

Probieren Sie es aus

function Monster(disposition) {
  this.disposition = disposition;
}

const handler = {
  construct(target, args) {
    console.log(`Creating a ${target.name}`);
    // Expected output: "Creating a monster"

    return new target(...args);
  },
};

const ProxiedMonster = new Proxy(Monster, handler);

console.log(new ProxiedMonster("fierce").disposition);
// Expected output: "fierce"

Syntax

new Proxy(target, {
  construct(target, argumentsList, newTarget) {
  }
})

Parameter

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

target: Das Ziel-Konstruktorobjekt.
argumentsList: Ein Array, das die an den Konstruktor übergebenen Argumente enthält.
newTarget: Der Konstruktor, der ursprünglich aufgerufen wurde.

Rückgabewert

Die construct() Methode muss ein Objekt zurückgeben, das das neu erstellte Objekt darstellt.

Beschreibung

Abfangmethoden

Diese Falle kann folgende Operationen abfangen:

Den new Operator: new myFunction(...args)
Reflect.construct()

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

Invarianten

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

Das target muss selbst ein Konstruktor sein.
Das Ergebnis muss ein Object sein.

Beispiele

Den new-Operator abfangen

Der folgende Code fängt den new Operator ab.

const p = new Proxy(function () {}, {
  construct(target, argumentsList, newTarget) {
    console.log(`called: ${argumentsList}`);
    return { value: argumentsList[0] * 10 };
  },
});

console.log(new p(1).value); // "called: 1"
// 10

Der folgende Code verletzt die Invariante.

const p = new Proxy(function () {}, {
  construct(target, argumentsList, newTarget) {
    return 1;
  },
});

new p(); // TypeError is thrown

Der folgende Code initialisiert den Proxy unsachgemäß. Das target bei der Proxy-Initialisierung muss selbst ein gültiger Konstruktor für den new Operator sein.

const p = new Proxy(
  {},
  {
    construct(target, argumentsList, newTarget) {
      return {};
    },
  },
);

new p(); // TypeError is thrown, "p" is not a constructor

Spezifikationen

Specification
ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-construct-argumentslist-newtarget