handler.apply()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since сентябрь 2016 г..
Метод handler.apply() является ловушкой для вызова функции.
Интерактивный пример
function sum(a, b) {
return a + b;
}
const handler = {
apply: function (target, thisArg, argumentsList) {
console.log(`Calculate sum: ${argumentsList}`);
// Expected output: "Calculate sum: 1,2"
return target(argumentsList[0], argumentsList[1]) * 10;
},
};
const proxy1 = new Proxy(sum, handler);
console.log(sum(1, 2));
// Expected output: 3
console.log(proxy1(1, 2));
// Expected output: 30
Синтаксис
const p = new Proxy(target, {
apply: function(target, thisArg, argumentsList) {
}
});
Параметры
Методу apply() передаются следующие параметры. this связан с объектом-обработчиком.
target-
Исходный объект.
thisArg-
Аргумент
thisдля вызова. argumentsList-
Список аргументов для вызова.
Возврат значения
Метод apply() может возвращать значение.
Описание
Метод handler.apply() является ловушкой для вызова функции.
Перехват
Ловушка может перехватывать следующие операции:
proxy(...args)Function.prototype.apply()иFunction.prototype.call()Reflect.apply()
Инварианты
Если следующие инварианты нарушены, то прокси выбросит TypeError.
Исходный объект target должен быть самовызываемым. То есть, это должна быть функция-объект.
Примеры
Ловушка для вызова функции
Следующий код ловит вызов функции.
js
const p = new Proxy(function () {}, {
apply: function (target, thisArg, argumentsList) {
console.log("called: " + argumentsList.join(", "));
return argumentsList[0] + argumentsList[1] + argumentsList[2];
},
});
console.log(p(1, 2, 3)); // "called: 1, 2, 3"
// 6
Спецификации
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-proxy-object-internal-methods-and-internal-slots-call-thisargument-argumentslist |