WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Reflect.apply — eine Funktion mit explizitem this und Argumenten aufrufen

Reflect.apply ruft eine Funktion mit einem angegebenen `this`-Wert und Argumenten aus einem übergebenen Objekt auf. Die Methode gibt das Ergebnis der Funktion zurück, ohne deren Eigenschaft `apply` zu lesen.

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.apply(target, thisArgument, argumentsList)

Reflect.apply(target, thisArgument, argumentsList) ruft target auf und übergibt thisArgument als this-Wert sowie die Elemente von argumentsList als aufeinanderfolgende Argumente. Die Methode gibt das Ergebnis des Aufrufs zurück; Ausnahmen werden weitergegeben. Sie erstellt keine Instanz und ersetzt nicht den Operator new.

argumentsList muss ein Objekt sein, braucht aber weder eine Eigenschaft length noch indizierte Eigenschaften. Die Methode liest length, wandelt den Wert in eine Länge um und liest dann die entsprechenden indizierten Eigenschaften. Fehlt length, wird die Länge als null behandelt: {} ist beispielsweise zulässig und liefert keine Argumente. Auch ein Array oder ein Objekt wie im Beispiel ist zulässig. Die Methode verwendet das Iterationsprotokoll nicht und übergibt daher die Elemente eines Set nicht als einzelne Argumente. Beim Lesen von Eigenschaften können Getter aufgerufen werden.

Ist target nicht aufrufbar oder ist argumentsList kein Objekt, tritt ein TypeError auf. Anders als bei Function.prototype.apply stehen weder ein weggelassenes argumentsList noch null oder undefined für eine leere Liste — übergib []. Die Methode liest target.apply nicht und funktioniert daher auch dann, wenn diese Eigenschaft verdeckt wurde.

Die Übergabe von thisArgument setzt die Regeln der Zielfunktion nicht außer Kraft: Eine Pfeilfunktion behält ihr lexikalisches this, und eine mit bind gebundene Funktion behält ihr gebundenes this. Eine gewöhnliche Funktion im Strict-Modus erhält den übergebenen Wert unverändert; außerhalb des Strict-Modus gelten die üblichen Regeln zur Konvertierung von this.

Beispiele

function total(a, b) {
  "use strict";
  return this.base + a + b;
}

const receiver = { base: 10 };
const args = { 0: 2, 1: 3, length: 2 };
console.log(Reflect.apply(total, receiver, args));

Ergebnis

15

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.

Quellen