Visitar URL original
handler.construct() - JavaScript | MDN

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 Methode handler.construct() ist ein Trap für die interne Objektmethode [[Construct]], die von Operationen wie dem new-Operator verwendet wird. Damit die new-Operation für das resultierende Proxy-Objekt gültig ist, muss das Zielobjekt, mit dem der Proxy initialisiert 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 Methode construct() übergeben. this ist an den Handler gebunden.

target

Das Ziel-Konstruktorobjekt.

argumentsList

Ein Array mit den Argumenten, die an den Konstruktor übergeben wurden.

newTarget

Der Konstruktor, der ursprünglich aufgerufen wurde.

Rückgabewert

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

Beschreibung

Abgefangene Operationen

Dieser Trap kann die folgenden Operationen abfangen:

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

Invarianten

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

  • 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 nicht ordnungsgemäß. target muss bei der Initialisierung des Proxys 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