Proxy 能拦截 13 种基本操作,包括 get、set、has、deleteProperty、apply、construct、ownKeys、getOwnPropertyDescriptor、defineProperty、preventExtensions、isExtensible、getPrototypeOf、setPrototypeOf。

Proxy 能拦截哪些基本操作?
JavaScript 的 Proxy 对象本身不执行任何逻辑,它只是在目标对象(target)被访问或修改时,提供一个“中间层”让你决定是否放行、改写或拒绝。它能拦截的操作由 handler 中的 trap(陷阱)方法定义,共 13 种标准 trap,覆盖读、写、构造、遍历、原型操作等全部关键行为。
常见且高频使用的包括:get、set、has、deleteProperty、apply、construct、ownKeys、getOwnPropertyDescriptor。不常用但存在的是 defineProperty、preventExtensions、isExtensible、getPrototypeOf、setPrototypeOf。
注意:Proxy 无法拦截属性是否存在判断(如 obj.prop !== undefined)本身,但可通过 has trap 拦截 in 运算符,通过 get trap 控制读取返回值来间接影响判断结果。
为什么 set 拦截常失效?
set trap 只在赋值语句明确写为 obj.key = value 或 obj['key'] = value 时触发;它不会拦截:
立即学习“Java免费学习笔记(深入)”;
- 对未定义属性的首次赋值(若 target 是普通对象,该属性会直接被创建)
- 通过
Object.defineProperty设置属性(需单独用definePropertytrap 拦截) - 数组索引赋值如
arr[0] = 1—— 实际会触发set,但若数组 length 变化,length属性的更新也走set,容易漏处理 - 原型链上的属性赋值(如父类有
foo,子实例this.foo = 1实际写入实例,仍走set;但若父类foo是 getter/setter,则根本不会进 Proxy 的set)
真正生效的前提是:你必须在 set trap 中显式返回 true 表示成功,否则严格模式下会抛 TypeError。默认不返回或返回 false 都会导致赋值失败。
const p = new Proxy({}, {
set(target, key, value) {
console.log('set', key, value);
// 必须返回 true,否则赋值静默失败(非严格模式)或报错(严格模式)
target[key] = value;
return true;
}
});
Reflect 是用来配合 Proxy 的,不是替代品
Reflect 是一组静态方法,命名和参数与 Proxy trap 完全对齐(如 Reflect.get() 对应 get trap),但它本身不创建代理,只提供标准化的对象操作接口。它的核心价值在于:
- 把原本散落在
Object、Function、操作符中的行为(如in、new、delete)统一为函数调用 - 让 Proxy handler 内部能安全、一致地转发操作到原对象,避免重复实现或遗漏 this 绑定问题
- 某些操作(如
Reflect.construct)比new target(...args)更可靠,尤其处理子类继承时
典型用法是在 trap 中调用对应 Reflect.xxx 方法完成默认行为:
const p = new Proxy(obj, {
get(target, key, receiver) {
console.log('getting', key);
// 而不是 target[key] —— receiver 用于保持 Proxy 链中 this 正确性
return Reflect.get(target, key, receiver);
}
});
实际开发中最容易忽略的三个点
一是 receiver 参数在 get/set 中的意义:它代表原始调用者(可能是 proxy 本身或其继承者),不传或传错会导致 super 访问、getter 中的 this 指向错误;
二是 ownKeys 和 getOwnPropertyDescriptor 必须成对使用:若你用 ownKeys 过滤掉某个属性,但没在 getOwnPropertyDescriptor 中返回 undefined 或相应 descriptor,for...in 和 Object.keys 行为可能不一致;
三是 Proxy 无法代理非对象类型(string、number、boolean、null、undefined),传入会直接报 TypeError: Cannot create proxy with a non-object as target or handler —— 包装成 Object(value) 也不行,因为原始值不可扩展。










