Object.getOwnPropertyDescriptors 实现完整对象克隆方法

本文深入解析了如何利用 `Object.getOwnPropertyDescriptors` 实现真正保留 getter/setter 访问器、不可枚举属性、Symbol 键及完整属性特性的精准对象克隆，直击 `Object.assign`、展开运算符和 JSON 序列化等常用方法在复制访问器函数时的根本性缺陷；通过结合 `Object.defineProperties` 与原型继承处理，提供语义清晰、可靠可控的克隆方案，并进一步拓展至支持按需递归的“半深克隆”，强调其核心价值不在于全自动深度复制，而在于精准守护易被忽略却至关重要的访问器逻辑与元属性信息——这是构建健壮响应式系统、代理封装和高级对象操作不可或缺的一环。

使用 Object.getOwnPropertyDescriptors 可以完整获取对象所有自有属性的描述符（包括 get、set、value、writable、enumerable、configurable），从而实现真正保留访问器（getter/setter）和属性特性的深克隆——注意，它本身只做**浅拷贝描述符**，但为完美克隆提供了最可靠的基础。

为什么普通方法无法正确克隆访问器

常见的克隆方式如 Object.assign、展开运算符 {...obj} 或 JSON.parse(JSON.stringify()) 都会丢失访问器：

• Object.assign 和展开运算符只读取属性值（触发 getter），不复制 get/set 函数本身；
• JSON 序列化完全忽略访问器和函数，连 undefined、Symbol、Date 等都丢失；
• Object.create(obj.__proto__, Object.getOwnPropertyDescriptors(obj)) 接近正确，但需手动处理原型链与不可枚举属性兼容性。

核心步骤：用 getOwnPropertyDescriptors + defineProperties 实现克隆

这是最直接、语义最清晰的方式：

• 调用 Object.getOwnPropertyDescriptors(source) 获取源对象所有自有属性的完整描述符对象；
• 创建一个新对象（可指定原型，如 Object.create(Object.getPrototypeOf(source))）；
• 用 Object.defineProperties(target, descriptors) 将所有描述符一次性定义到目标对象上。

示例：

function cloneWithAccessors(obj) {
  const descriptors = Object.getOwnPropertyDescriptors(obj);
  const prototype = Object.getPrototypeOf(obj);
  return Object.defineProperties(Object.create(prototype), descriptors);
}
<p>const source = {
_x: 10,
get x() { return this._x * 2; },
set x(v) { this._x = v / 2; }
};</p><p>const cloned = cloneWithAccessors(source);
console.log(cloned.x); // 20
cloned.x = 40;
console.log(cloned._x); // 20 ✅ 访问器正常工作
</p>

处理特殊情况：不可枚举属性、Symbol 键、继承属性

getOwnPropertyDescriptors 默认只返回**自有、可枚举 + 不可枚举**属性（不含 Symbol？错！它包含所有自有属性，包括不可枚举的，也包括 Symbol 键）：

• ✅ 自动包含 Symbol 类型的自有属性（如 Symbol('id')）；
• ✅ 包含不可枚举属性（如通过 Object.defineProperty(obj, 'hidden', { enumerable: false, ... }) 定义的）；
• ❌ 不包含原型链上的继承属性（这是设计使然，符合“own”的语义）；若需克隆整个原型行为，应显式处理原型（如上例中用 Object.getPrototypeOf）；
• ⚠️ 若源对象有 [[Get]]/[[Set]] 但无对应 get/set 描述符（比如 Proxy），该方法不适用——getOwnPropertyDescriptors 对 Proxy 返回空对象或代理定义的描述符，需单独判断。

进阶：支持简单嵌套对象的“半深克隆”（按需递归）

getOwnPropertyDescriptors 本身不递归，但可封装一层逻辑，在遇到普通对象（非 null、非 Date/RegExp/Map/Set 等内置类型）时递归克隆其属性值：

• 遍历每个 descriptor，若 value 是纯对象（isObject(value) && !isBuiltInType(value)），则递归调用克隆函数；
• 对 get/set 函数不递归（它们是函数，保持原引用即可）；
• 注意：value 为 null 或原始值（string/number/boolean）直接保留；
• 此方式仍属“浅克隆访问器 + 深克隆数据属性”，兼顾安全性与可控性。

关键不是追求全自动深克隆，而是让访问器这类易丢失的关键结构被精准保留——这正是 getOwnPropertyDescriptors 不可替代的价值。

好了，本文到此结束，带大家了解了《Object.getOwnPropertyDescriptors 实现完整对象克隆方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！