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년 9월.

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

구문

js
var 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를 발생시킵니다.

대상 객체는 그 자체로 호출이 가능해야합니다. 즉, 함수 객체여야 합니다.

예제

함수 호출 가로채기

다음 코드는 함수 호출을 트랩합니다.

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)); // "호출: 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 2025년 2월 11일 by MDN contributors.

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

handler.apply()

In this article

Help improve MDN