Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

handler.construct()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2016 browserübergreifend verfügbar.

Die handler.construct() Methode ist ein Trap für die [[Construct]] interne Methode des Objekts, die von Operationen wie dem new Operator verwendet wird. Damit die neue Operation auf dem resultierenden Proxy-Objekt gültig ist, muss das Ziel, das zur Initialisierung des Proxy verwendet wird, 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

js
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-Konstruktor-Objekt.

argumentsList

Ein Array, das die an den Konstruktor übergebenen Argumente enthält.

newTarget

Der ursprünglich aufgerufene Konstruktor.

Rückgabewert

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

Beschreibung

Abfangmöglichkeiten

Dieser Trap kann folgende Operationen abfangen:

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

Invarianten

Die [[Construct]] interne Methode des Proxys wirft einen TypeError, wenn die Definition des Handlers 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.

js
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.

js
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.

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch