JavaScript反射机制_ReflectAPI详解_技术教程

Reflect是ES6引入的内置对象，提供函数式API统一操作对象，支持与Proxy配合实现元编程。

JavaScript 中的反射机制主要通过 Reflect API 实现。它提供了一组静态方法，用于拦截 JavaScript 操作，并与对象的元编程行为进行交互。Reflect 并不是一个构造函数或可实例化的类，而是一个内置对象，其方法与 Proxy 的陷阱（traps）一一对应，使得操作对象更安全、更一致。

Reflect 是什么？

Reflect 是 ES6 引入的内置对象，它的设计初衷是为了统一和规范化对对象的操作方式。以前很多操作是命令式的，比如 delete obj.key、'key' in obj 等，而 Reflect 提供了对应的函数式调用方式，使代码更易于处理和封装。

Reflect 的另一个重要用途是配合 Proxy 使用。当使用 Proxy 拦截对象操作时，内部常常需要调用默认行为，这时就可以使用 Reflect 来完成。

常用 Reflect 方法详解

1. Reflect.get(target, key, receiver)

获取对象上的属性值，支持自定义 getter 绑定 this。

target：目标对象
key：要获取的属性名
receiver：可选，指定 getter 执行时的 this 值（常为 proxy 实例）

示例：

const obj = { value: 1 };
const proxy = new Proxy(obj, {
  get(target, key, receiver) {
    console.log(`Getting ${key}`);
    return Reflect.get(target, key, receiver);
  }
});
console.log(proxy.value); // 输出：Getting value \n 1

2. Reflect.set(target, key, value, receiver)

设置对象属性值，支持自定义 setter。

返回布尔值，表示是否设置成功（严格模式下失败会抛错）

示例：

const obj = { _count: 0 };
Object.defineProperty(obj, 'count', {
  set(val) {
    this._count = val > 0 ? val : 0;
  },
  get() {
    return this._count;
  }
});

const proxy = new Proxy(obj, {
  set(target, key, value, receiver) {
    if (key === 'count') {
      console.log(`Setting count to ${value}`);
    }
    return Reflect.set(target, key, value, receiver);
  }
});

proxy.count = -5; // 输出：Setting count to -5，但实际值仍为 0（由 setter 控制）

3. Reflect.has(target, key)

判断对象是否拥有某个属性，相当于 in 操作符的函数化。

const obj = { name: 'Alice' };
console.log(Reflect.has(obj, 'name')); // true
console.log(Reflect.has(obj, 'toString')); // true（继承属性也算）

4. Reflect.deleteProperty(target, key)

删除对象属性，相当于 delete obj.key，但更安全且返回布尔值。

const obj = { name: 'Bob' };
console.log(Reflect.deleteProperty(obj, 'name')); // true
console.log('name' in obj); // false

5. Reflect.ownKeys(target)

返回对象自身所有属性名（包括字符串和 Symbol），不包含继承属性。

const obj = { a: 1 };
obj[Symbol.for('s')] = 2;
console.log(Reflect.ownKeys(obj)); // ['a', Symbol(s)]

6. Reflect.getOwnPropertyDescriptor(target, key)

获取属性描述符，比 Object.getOwnPropertyDescriptor 更安全（不会抛错，无效 target 返回 undefined）。

const desc = Reflect.getOwnPropertyDescriptor({ a: 1 }, 'a');
console.log(desc); // { value: 1, writable: true, enumerable: true, configurable: true }

7. Reflect.defineProperty(target, key, descriptor)

定义属性，类似 Object.defineProperty，但返回布尔值而不是抛出错误。

const obj = {};
if (Reflect.defineProperty(obj, 'x', { value: 42 })) {
  console.log('定义成功');
} else {
  console.log('定义失败');
}

8. Reflect.apply(func, thisArg, args)

调用函数，等价于 Function.prototype.apply。

function add(a, b) {
  return a + b;
}
console.log(Reflect.apply(add, null, [2, 3])); // 5

9. Reflect.construct(target, args)

创建新实例，等价于 new target(...args)。

class Person {
  constructor(name) {
    this.name = name;
  }
}
const p = Reflect.construct(Person, ['Charlie']);
console.log(p.name); // Charlie

Reflect 与 Proxy 配合使用

在 Proxy 的陷阱中，推荐使用 Reflect 来保留默认行为，这样可以确保操作的一致性和正确性，尤其是在涉及原型链或 getter/setter 的场景。

const observed = new WeakMap();

const handler = {
  get(target, key, receiver) {
    console.log(`GET ${String(key)}`);
    return Reflect.get(target, key, receiver);
  },
  set(target, key, value, receiver) {
    const result = Reflect.set(target, key, value, receiver);
    console.log(`SET ${String(key)} = ${value}`);
    return result;
  }
};

const obj = {};
const proxy = new Proxy(obj, handler);
proxy.name = 'Test'; // SET name = Test
console.log(proxy.name); // GET name \n Test