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.apply()

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.apply() ist ein Trap für die objektinterne Methode [[Call]], die bei Operationen wie Funktionsaufrufen verwendet wird.

Probieren Sie es aus

function sum(a, b) {
  return a + b;
}

const handler = {
  apply(target, thisArg, argumentsList) {
    console.log(`Calculate sum: ${argumentsList}`);
    // Expected output: "Calculate sum: 1,2"

    return target(argumentsList[0], argumentsList[1]) * 10;
  },
};

const proxy = new Proxy(sum, handler);

console.log(sum(1, 2));
// Expected output: 3
console.log(proxy(1, 2));
// Expected output: 30

Syntax

js
new Proxy(target, {
  apply(target, thisArg, argumentsList) {
  }
})

Parameter

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

target

Das aufrufbare Zielobjekt.

thisArg

Das this-Argument für den Aufruf.

argumentsList

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

Rückgabewert

Die Methode apply() kann einen beliebigen Wert zurückgeben, der den Rückgabewert des Funktionsaufrufs darstellt.

Beschreibung

Abgefangene Operationen

Dieser Trap kann die folgenden Operationen abfangen:

Ebenso jede andere Operation, die die interne Methode [[Call]] aufruft.

Invarianten

Die interne Methode [[Call]] des Proxys löst einen TypeError aus, wenn die Handler-Definition gegen die folgende Invariante verstößt:

  • target muss selbst aufrufbar sein. Das heißt, es muss ein Funktionsobjekt sein.

Beispiele

Einen Funktionsaufruf abfangen

Der folgende Code fängt einen Funktionsaufruf ab.

js
const p = new Proxy(function () {}, {
  apply(target, thisArg, argumentsList) {
    console.log(`called: ${argumentsList}`);
    return argumentsList[0] + argumentsList[1] + argumentsList[2];
  },
});

console.log(p(1, 2, 3)); // "called: 1,2,3"
// 6

Spezifikationen

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

Browser-Kompatibilität

Siehe auch