如何掌握JavaScript中的代理与反射_JavaScript的Proxy对象可以拦截哪些操作

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

Proxy 能拦截哪些基本操作?

JavaScript 的 Proxy 对象本身不执行任何逻辑,它只是在目标对象(target)被访问或修改时,提供一个“中间层”让你决定是否放行、改写或拒绝。它能拦截的操作由 handler 中的 trap(陷阱)方法定义,共 13 种标准 trap,覆盖读、写、构造、遍历、原型操作等全部关键行为。

常见且高频使用的包括:getsethasdeletePropertyapplyconstructownKeysgetOwnPropertyDescriptor。不常用但存在的是 definePropertypreventExtensionsisExtensiblegetPrototypeOfsetPrototypeOf

注意:Proxy 无法拦截属性是否存在判断(如 obj.prop !== undefined)本身,但可通过 has trap 拦截 in 运算符,通过 get trap 控制读取返回值来间接影响判断结果。

为什么 set 拦截常失效?

set trap 只在赋值语句明确写为 obj.key = valueobj['key'] = value 时触发;它不会拦截:

  • 对未定义属性的首次赋值(若 target 是普通对象,该属性会直接被创建)
  • 通过 Object.defineProperty 设置属性(需单独用 defineProperty trap 拦截)
  • 数组索引赋值如 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),但它本身不创建代理,只提供标准化的对象操作接口。它的核心价值在于:

  • 把原本散落在 ObjectFunction、操作符中的行为(如 innewdelete)统一为函数调用
  • 让 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 指向错误;

二是 ownKeysgetOwnPropertyDescriptor 必须成对使用:若你用 ownKeys 过滤掉某个属性,但没在 getOwnPropertyDescriptor 中返回 undefined 或相应 descriptor,for...inObject.keys 行为可能不一致;

三是 Proxy 无法代理非对象类型(stringnumberbooleannullundefined),传入会直接报 TypeError: Cannot create proxy with a non-object as target or handler —— 包装成 Object(value) 也不行,因为原始值不可扩展。