Proxy.apply 陷阱（trap）是 JavaScript 中 Proxy 对象用于拦截函数调用的一种机制。它专门用于代理可调用对象（即函数），当该代理函数被调用时，会触发 apply 陷阱。
一、apply 捕获器基础
1. 核心定义
apply 是 Proxy 的一个捕获器方法，当被代理的对象是函数，且该函数被调用（包括直接调用、call/apply 调用）时，会触发 apply 捕获器，你可以在其中拦截、修改函数调用的行为。2. 语法结构
const proxy = new Proxy(target, {// apply 捕获器的语法apply(target, thisArg, argumentsList) {// 拦截逻辑// 最终可返回修改后的结果，或调用原函数返回结果return Reflect.apply(target, thisArg, argumentsList);}
});参数说明：
target：被代理的原函数（必须是函数类型，否则apply不会触发）；thisArg：调用函数时绑定的this指向；argumentsList：调用函数时传入的参数数组（类数组对象）；- 返回值：
apply捕获器的返回值会作为函数调用的最终结果。
3. 触发场景
只要是对代理后的函数进行 “调用操作”，都会触发
apply：- 直接调用：
proxy()； call调用：proxy.call(obj, 1, 2)；apply调用：proxy.apply(obj, [1, 2])；- 注意：
bind不会直接触发apply（bind返回新函数），但调用bind后的新函数时会触发。
二、实战示例
示例 1：基础拦截（打印调用信息）
// 原函数：求和
function sum(a, b) {return a + b;
}// 创建代理，拦截函数调用
const sumProxy = new Proxy(sum, {apply(target, thisArg, args) {// 1. 拦截：打印调用信息console.log(`函数 sum 被调用，参数：${args.join(', ')}`);console.log(`绑定的 this 指向：`, thisArg);// 2. 调用原函数（推荐用 Reflect.apply，更规范）const result = Reflect.apply(target, thisArg, args);// 3. 拦截返回值（比如翻倍）return result * 2;}
});// 测试调用
console.log(sumProxy(1, 2)); // 输出：函数 sum 被调用，参数：1, 2 → 绑定的 this 指向：undefined → 6
console.log(sumProxy.call(null, 3, 4)); // 输出：函数 sum 被调用，参数：3, 4 → 绑定的 this 指向：null → 14示例 2：参数校验 / 修正
// 原函数：计算平方
function square(num) {return num * num;
}const squareProxy = new Proxy(square, {apply(target, thisArg, args) {// 拦截：校验参数类型，非数字则修正为 0const [num] = args;if (typeof num !== 'number') {console.warn('参数必须是数字，已自动修正为 0');args[0] = 0;}return Reflect.apply(target, thisArg, args);}
});console.log(squareProxy(5)); // 25
console.log(squareProxy('abc')); // 警告 → 0三、关键注意点
-
- 仅对函数生效：如果
target不是函数（比如对象、数字），调用代理对象时不会触发apply，甚至可能报错； - Reflect.apply 的作用：
Reflect.apply(target, thisArg, args)是调用原函数的标准方式，等价于target.apply(thisArg, args)，但更符合 Proxy/Reflect 的设计理念（语义更清晰）； - 返回值可控：你可以完全不调用原函数，直接返回自定义结果（比如模拟函数返回值）。
- 仅对函数生效：如果
总结
-
apply捕获器专用于拦截函数对象的调用操作（直接调用、call/apply），参数包含原函数、this指向、调用参数；- 核心用途是监控函数调用、校验 / 修改参数、拦截返回值，不改变原函数逻辑的前提下扩展函数行为；
- 推荐使用
Reflect.apply调用原函数，保证代码的规范性和可维护性。