应使用 Reflect.getOwnPropertyDescriptor 而非 Object.getOwnPropertyDescriptor，因其对非对象参数（如 null）不抛错而返回 undefined，提升错误处理安全性，尤其适用于工具函数、Proxy 拦截及用户输入场景。

Reflect.getOwnPropertyDescriptor 是一个安全获取对象属性描述符的方法，相比直接调用 Object.getOwnPropertyDescriptor，它不会因传入非对象参数而抛出错误，而是统一返回 undefined，更适合在不确定输入类型时使用。

为什么用 Reflect.getOwnPropertyDescriptor 而不是 Object.getOwnPropertyDescriptor？

主要区别在于**错误处理方式不同**：

• Object.getOwnPropertyDescriptor(null, 'x') 会立即抛出 TypeError
• Reflect.getOwnPropertyDescriptor(null, 'x') 安静返回 undefined

这意味着你无需每次都手动检查参数是否为对象，尤其适合写工具函数、代理逻辑或处理用户输入的场景。

基本用法：获取自有属性的描述符

语法与 Object.getOwnPropertyDescriptor 完全一致：

立即学习“Java免费学习笔记（深入）”；

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

Reflect.getOwnPropertyDescriptor(target, propertyKey)

例如：

const obj = { a: 1 };
Object.defineProperty(obj, 'b', { value: 2, writable: false, enumerable: true });

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

console.log(Reflect.getOwnPropertyDescriptor(obj, 'b'));
// { value: 2, writable: false, enumerable: true, configurable: true }

console.log(Reflect.getOwnPropertyDescriptor(obj, 'c'));
// undefined（属性不存在）

console.log(Reflect.getOwnPropertyDescriptor(null, 'x'));
// undefined（不报错！）

配合 Proxy 实现更健壮的属性访问拦截

在 Proxy 的 getOwnPropertyDescriptor 拦截器中，必须返回一个描述符对象或 undefined。使用 Reflect.getOwnPropertyDescriptor 可以自然地转发请求并保持语义一致：

const handler = {
  getOwnPropertyDescriptor(target, prop) {
    // 安全获取，即使 target 不是对象也不崩
    const desc = Reflect.getOwnPropertyDescriptor(target, prop);
    if (desc) {
      return { ...desc, enumerable: true }; // 可安全修改后返回
    }
    return undefined;
  }
};

const proxy = new Proxy({ x: 1 }, handler);
console.log(Reflect.getOwnPropertyDescriptor(proxy, 'x')); // 正常返回修改后的描述符

注意：只查自有属性，不查原型链

和 Object.getOwnPropertyDescriptor 一样，它**不会沿着原型链查找**。如果想检查继承来的属性，需手动遍历原型链：

• 用 Reflect.getPrototypeOf(obj) 获取原型
• 递归调用 Reflect.getOwnPropertyDescriptor 直到找到或原型为 null

例如封装一个查找属性描述符（含原型）的工具函数：

function getPropertyDescriptor(obj, key) {
  let current = obj;
  while (current != null) {
    const desc = Reflect.getOwnPropertyDescriptor(current, key);
    if (desc) return desc;
    current = Reflect.getPrototypeOf(current);
  }
  return undefined;
}