JavaScript 反射通过 Reflect 对象提供运行时动态操作对象的标准化 API,包括 get、set、has、deleteProperty、construct、apply 等 12 个静态方法,全部返回布尔值或明确结果,不抛错,专为配合 Proxy 实现安全、一致的元编程。

JavaScript 反射(Reflection)指的是在运行时动态检查、读取甚至修改对象结构和行为的能力。它不改变语言的语法,而是通过一套标准化的 API(即 Reflect 对象)提供对底层操作的可控访问,比如属性访问、函数调用、原型设置等。这些操作原本是隐式发生的(如 obj.prop 或 new C()),而 Reflect 把它们显式化、可拦截化,主要配合 Proxy 使用,让元编程更安全、更一致。
Reflect 提供的方法有哪些
Reflect 是一个内置的、不可构造的对象,所有方法都是静态的,返回布尔值或具体结果,失败时不抛错(多数返回 false),语义上与对应的操作符/语法一一对应。常用方法包括:
-
Reflect.get(target, key, receiver):读取属性值,支持指定receiver(影响this绑定),比target[key]更可控,尤其在 Proxy 中用于正确转发 get 操作。 -
Reflect.set(target, key, value, receiver):设置属性值,返回布尔值表示是否成功(区分于=的静默失败),同样支持receiver。 -
Reflect.has(target, key):等价于key in target,返回布尔值,常用于 Proxy 的has拦截器。 -
Reflect.deleteProperty(target, key):等价于delete target[key],返回布尔值,明确指示是否删除成功。 -
Reflect.construct(target, args, newTarget?):替代new target(...args),支持指定构造函数的new.target(即newTarget),便于代理构造过程。 -
Reflect.apply(target, thisArg, args):替代target.apply(thisArg, args),更简洁安全,避免target非函数时报错(此时直接返回false)。 -
Reflect.defineProperty(target, key, descriptor):类似Object.defineProperty,但失败时返回false而非抛错,适合需要容错的场景。 -
Reflect.getOwnPropertyDescriptor(target, key):获取自有属性描述符,不查找原型链,行为与Object.getOwnPropertyDescriptor一致。 -
Reflect.getPrototypeOf(target)和Reflect.setPrototypeOf(target, proto):分别替代Object.getPrototypeOf和Object.setPrototypeOf,后者返回布尔值表示是否设置成功。 -
Reflect.isExtensible(target)、Reflect.preventExtensions(target):对应对象扩展性控制,统一返回布尔值。 -
Reflect.ownKeys(target):返回对象所有自有属性键(包括 Symbol),等价于Object.getOwnPropertyNames(target).concat(Object.getOwnPropertySymbols(target)),常用于 Proxy 的ownKeys拦截器。
为什么用 Reflect 而不是直接操作
单独使用 Reflect 并不比点号或括号语法“更强大”,它的价值在于三点:
- 与
Proxy拦截器方法签名完全匹配,例如 Proxy 的get拦截器参数顺序和Reflect.get一致,可直接转发:return Reflect.get(target, key, receiver);,避免手动模拟行为出错。 - 所有方法都统一返回布尔值或明确结果,失败不抛异常(如
set、defineProperty),便于做条件判断和错误处理。 - 把原本隐式的语言内部操作(如函数调用、构造、原型设置)暴露为可编程接口,使元编程逻辑更清晰、可测试、可组合。
一个典型配合 Proxy 的例子
想拦截并记录所有属性读取:
立即学习“Java免费学习笔记(深入)”;
const obj = { x: 1 };
const proxy = new Proxy(obj, {
get(target, key, receiver) {
console.log(`读取属性: ${key}`);
return Reflect.get(target, key, receiver); // 安全转发
}
});
console.log(proxy.x); // 输出 "读取属性: x" 和 1
这里用 Reflect.get 而不是 target[key],是为了保证 receiver 正确传递(影响 getter 中的 this),也符合 Proxy 规范推荐做法。











