17370845950

Reflect API 是 JavaScript 提供的统一操作对象的静态方法集，解决传统操作错误处理不一致、无法动态拦截等问题；其方法如 Reflect.get、Reflect.set 等与 Proxy trap 一一对应，返回明确结果，支持安全读写、构造调用等，并天然适配 Proxy 拦截。

Reflect API 是 JavaScript 提供的一组静态方法，用于以更规范、更函数式的方式操作对象，它和 Proxy 的 trap 方法一一对应，本质是把原本分散在 Object、Function 等构造器或操作符（如 in、delete、new）中的底层操作，统一封装成可调用的函数。

为什么需要 Reflect API

过去很多对象操作直接用语法或 Object 方法，但存在几个问题：错误处理不一致（比如 obj.prop 访问不存在属性返回 undefined，而 delete obj.prop 却静默失败）、无法动态拦截（Proxy 需要明确的 trap 名称）、部分操作没有对应方法（如 new 或 super 调用）。Reflect 就是为了解决这些，让所有基本操作都变成可编程、可代理、可捕获的函数调用。

常见 Reflect 方法及用途

每个 Reflect 方法都返回布尔值或具体结果，且多数与 Proxy 的 trap 同名，便于配合使用：

• Reflect.get(target, key, receiver) —— 安全读取属性，支持自定义 this（receiver），替代 target[key]
• Reflect.set(target, key, value, receiver) —— 安全赋值，返回 true 或 false 表示是否成功，替代 target[key] = value
• Reflect.has(target, key) —— 对应 key in target，返回布尔值
• Reflect.deleteProperty(target, key) —— 对应 delete target[key]，返回布尔值（不再静默失败）
• Reflect.construct(target, args, newTarget?) —— 替代 new target(...args)，支持指定构造器原型链
• Reflect.apply(target, thisArg, args) —— 替代 target.apply(thisArg, args)，更直观的函数调用方式
• Reflect.ownKeys(target) —— 返回所有自身属性键（含 Symbol），比 Object.keys() 更完整

和 Proxy 搭配使用最自然

Reflect 方法的设计初衷就是和 Proxy 的 trap 保持签名一致，方便在 handler 中直接转发。例如：

const handler = {
  get(target, key, receiver) {
    console.log(`读取 ${key}`);
    return Reflect.get(target, key, receiver); // 直接委托，语义清晰
  },
  set(target, key, value, receiver) {
    if (key === 'age' && value < 0) return false;
    return Reflect.set(target, key, value, receiver);
  }
};

这样既保留了原始行为，又便于添加逻辑，避免手动实现 [[Get]] 或 [[Set]] 的复杂规则。

不是用来替代 Object 方法的工具

Reflect 并不提供新功能，也不比 Object 方法“更快”或“更推荐日常使用”。它的核心价值在于：统一操作接口、支持元编程、提升 Proxy 可维护性。普通业务代码中仍应优先用 obj.key、Object.keys() 等简洁写法；只有在需要动态控制、拦截、或构建抽象层（如响应式系统、数据验证代理）时，才显现出 Reflect 的不可替代性。