Object.getOwnPropertyDescriptors可完整获取对象自有属性描述符,实现保留getter/setter的精准克隆;普通方法如Object.assign、展开运算符和JSON序列化均无法复制访问器函数本身。

使用 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 不可替代的价值。










