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® 2027 Language Specification
# sec-proxy-object-internal-methods-and-internal-slots-call-thisargument-argumentslist

Совместимость с браузерами

Enable JavaScript to view this browser compatibility table.

Смотрите также

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 17 февр. 2025 г. by MDN contributors.

View this page on GitHub • Report a problem with this content

Стандартные встроенные объекты
Proxy/handler
Методы экземпляра
Наследование
Object/Function
Статические методы
Статические свойства
Методы экземпляра
Свойства экземпляра
1. Object.prototype.__proto__
2. Object.prototype.constructor
Похожие страницы
Proxy

handler.apply()

In this article

Help improve MDN