CKTIS / JavaScript
Reflect.construct — einen Konstruktor mit einer Argumentliste aufrufen
Reflect.construct ruft einen Konstruktor mit Argumenten auf, die aus einem Objekt gelesen werden. Mit dem optionalen newTarget lässt sich der ausgeführte Konstruktor vom Wert von new.target und von der üblichen Prototypauswahl trennen.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
Reflect.construct(target, argumentsList)
Reflect.construct(target, argumentsList, newTarget)Reflect.construct(target, argumentsList) führt eine Konstruktion aus und keinen gewöhnlichen Funktionsaufruf. Die Methode funktioniert auch mit Klassen. Anders als Reflect.apply akzeptiert sie kein bereits vorhandenes this.
argumentsList muss ein Objekt sein. Reflect.construct liest dessen Eigenschaft length und ermittelt daraus, welche indizierten Eigenschaften es liest. Fehlt length, wird die Länge als 0 behandelt. Ist target ein Konstruktor, ruft Reflect.construct(target, {}) ihn daher ohne Argumente auf. Die Spread-Syntax in new target(...argumentsList) bezieht die Argumente dagegen aus dem Iterator. Ein Array mit einem benutzerdefinierten Iterator kann daher bei den beiden Aufrufen unterschiedliche Argumente an denselben Konstruktor übergeben. Iterierbarkeit allein reicht nicht aus; ein Set stellt seine Elemente Reflect.construct nicht bereit. Sowohl target als auch ein angegebenes newTarget müssen Konstruktoren sein — Pfeilfunktionen sind keine. Ungültige Argumente verursachen einen TypeError; Ausnahmen aus dem Konstruktor werden weitergegeben.
Wird newTarget weggelassen, ist es standardmäßig target; wird ausdrücklich undefined übergeben, tritt ein TypeError auf. Reflect.construct übergibt newTarget an die interne Operation [[Construct]] von target. Ist target eine gewöhnliche Konstruktorfunktion, hat new.target in ihrem Funktionskörper den Wert newTarget. Ist target hingegen ein Proxy, kann dessen construct-Trap newTarget ignorieren und den zugrunde liegenden Konstruktor mit einem anderen Wert für new.target aufrufen. Bei der gewöhnlichen Objekterzeugung stammt der Prototyp des Objekts von newTarget.prototype, sofern dieser Wert ein Objekt ist. Der Funktionskörper von newTarget wird dadurch nicht ausgeführt. Gibt target ausdrücklich ein Objekt zurück, kann dieses die erstellte Instanz ersetzen.
Im Beispiel setzt Person die Felder, der Prototyp stammt jedoch von Alternate. Das Ergebnis ist daher keine Instanz von Person. Dies ist eine Funktion der ECMAScript-Sprache und keine Web-API; die Verfügbarkeit in bestimmten Browsern muss gesondert geprüft werden.
Beispiele
function Person(name) {
this.name = name;
this.usedAlternate = new.target === Alternate;
}
function Alternate() {
throw new Error("Must not run");
}
const person = Reflect.construct(Person, ["Ada"], Alternate);
console.log(person.name);
console.log(person.usedAlternate);
console.log(Object.getPrototypeOf(person) === Alternate.prototype);
console.log(person instanceof Person);Ergebnis
Ada true true false
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.