Reflect 是 JavaScript 暴露内部操作的静态对象,方法命名统一、返回布尔值、行为更底层;与 Proxy 协作,Proxy 拦截操作,Reflect 执行默认行为,实现职责分离与元编程规范。

Reflect 是 JavaScript 的内置静态对象,它把原本隐式执行的语言内部操作(比如读属性、设值、调用函数)暴露为显式的函数方法。它本身不能被构造,也没有实例,所有方法都是静态的,就像 Math 一样。
Reflect 的核心作用
它让对象操作更规范、可预测、易组合:
- 方法命名统一:比如
Reflect.get()对应obj.prop,Reflect.set()对应obj.prop = val - 多数方法返回布尔值表示是否成功(如
Reflect.deleteProperty()),避免抛异常 - 替代部分
Object静态方法,行为更底层、更一致(例如Reflect.ownKeys()比Object.keys()更完整,能拿到不可枚举和 Symbol 键) - 在 Proxy 中天然适配——它的每个方法都与 Proxy handler 的 trap 一一对应
Proxy 和 Reflect 是协作关系,不是替代关系
Proxy 负责“拦截”,Reflect 负责“执行默认行为”。写 Proxy 时,几乎总是配合 Reflect 使用,否则容易出错或丢失原始语义:
分析 Java Spring Boot 后端 Controller 代码,自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 不直接写
target[prop],而用Reflect.get(target, prop, receiver)—— 它自动处理receiver(即 this 绑定),避免原型链访问出错 - 不手动赋值
target[prop] = value,而用Reflect.set(target, prop, value, receiver)—— 它返回布尔值,且尊重 setter、writable 等属性描述符 - 比如
apply或constructtrap 中,用Reflect.apply()或Reflect.construct()可安全复现原行为
为什么设计成两个独立对象?
职责分离更清晰:
立即学习“Java免费学习笔记(深入)”;
- Proxy 是“控制流入口”:你定义什么时候、什么条件下要干预操作
- Reflect 是“标准操作出口”:提供一套稳定、无副作用、可复用的底层操作封装
- 未来 Object 上的部分方法会逐步迁移到 Reflect(如
Reflect.setPrototypeOf()已是推荐方式,Object.setPrototypeOf()被标记为不推荐)
基本上就这些。用 Proxy 拦截,用 Reflect 执行——两者搭在一起,才是现代 JS 元编程的正确姿势。

















