Reflect是为元编程设计的反射API,统一标准化反射操作,核心价值在于配合Proxy实现可拦截、可委托、失败不抛错的底层能力封装。
Reflect 不是用来“简化反射操作”的,它是把原本散落在 Object 和语言内部的反射能力,统一收口、标准化、可拦截化。直接用它写业务代码反而更啰嗦,它的价值在 Proxy 配合和底层能力封装。
表面看 Reflect.get(obj, 'key') 就是 obj.key 的函数式写法,但关键差异在于:它支持显式传入 receiver(决定 this 绑定),且对访问器属性、原型链、undefined 属性值等行为定义更明确、更一致。
常见误用场景:
receiver —— 导致访问器属性里的 this 指向错误(尤其在 Proxy 中)const obj = {
get value() { return this._v; },
_v: 42
};
const proxy = new Proxy(obj, {
get(target, key, receiver) {
console.log('get intercepted');
// 必须传 receiver,否则 this 在 getter 中指向 target 而非 proxy
return Reflect.get(target, key, receiver);
}
});
lect.defineProperty 要比 Object.defineProperty 更可靠Object.defineProperty 在失败时抛异常(比如对不可扩展对象添加属性),而 Reflect.defineProperty 返回布尔值,符合“操作是否成功”的语义,更适合做防御性判断或封装。
使用建议:
Reflect.defineProperty
Object.isExtensible 或 Object.getOwnPropertyDescriptor 做前置检查,再调用 Reflect.defineProperty
if (Reflect.defineProperty(obj, 'x', { value: 1, writable: false })) {
console.log('property set');
} else {
console.log('failed — maybe object is sealed or property exists with incompatible descriptor');
}
不是语法替代,而是语义补全:Reflect.construct(target, args, newTarget?) 显式分离了构造目标、参数列表、以及可选的 new.target 模拟对象。这对实现自定义类继承、代理构造函数、或运行时动态实例化很关键。
容易踩的坑:
args(必须是数组,哪怕空数组 [])newTarget 可省略就能模拟普通 new —— 实际上省略时等价于 target,不等于原始 new 的 new.target 行为construct trap 中必须返回对象,否则报 TypeError;而 Reflect.construct 是唯一安全调用原构造逻辑的方式function MyCls(name) { this.name = name; }
const instance = Reflect.construct(MyCls, ['Alice'], class extends MyCls {}); // newTarget 影响 instanceof 结果
因为函数调用本身不是“反射操作”,而是执行行为。JS 已有 func.call(thisArg, ...args) 和 func.apply(thisArg, args),足够明确。加一个 Reflect.apply(func, thisArg, args) 纯粹是为了在 Proxy 的 apply trap 中能干净地转发调用 —— 它本质是“让 apply 可被拦截”的配套工具,不是为了写得更短。
所以你不会在日常函数调用里用它,除非你在写:
this 和参数数组(比如装饰器、AOP)Function.prototype.apply.call(...) 这种嵌套写法const handler = {
apply(target, thisArg, args) {
console.log(`calling ${target.name} with`, args);
return Reflect.apply(target, thisArg, args); // 安全转发
}
};
真正要用好 Reflect,得先理解它不是给业务层减负的,而是给元编程铺路的 —— 所有方法都设计成“可被 Proxy trap 直接委托”,且失败时不抛错、返回确定值。漏掉 receiver、乱传参数、或者拿它当语法糖用,反而会让代码更难 debug。