如何利用 Object.getOwnPropertyDescriptors 完整克隆一个包含私有访问器的复杂对象

首页

前端开发

热心网友

转载

2026-04-24

如何利用 Object.getOwnPropertyDescriptors 完整克隆一个包含私有访问器的复杂对象

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

开门见山地说，如果你指望用 Object.getOwnPropertyDescriptors 来完整克隆一个包含私有字段或私有访问器的对象，那这条路从一开始就走不通。原因很简单：Ja vaScript 的私有成员（#field、get #prop() 等）在设计上就是**运行时不可枚举、不可反射、不可遍历**的。这意味着，无论是 Object.getOwnPropertyDescriptors、Reflect.ownKeys，还是 for...in 循环，面对私有成员都完全“视而不见”——它们就像被语言机制刻意隐藏了起来。

为什么私有成员无法被 getOwnPropertyDescriptors 捕获

这并非引擎实现的疏漏，而是语言的核心设计原则。私有名称（#xxx）的作用域被严格限定在类定义的内部，从根本上就不参与常规的属性反射机制。无论是 V8 还是 SpiderMonkey，所有主流引擎都明确将私有字段和访问器排除在元属性 API 之外。因此，你会发现：

调用 Object.getOwnPropertyDescriptors(instance) 返回的，要么是一个空对象，要么只包含公有属性的描述符。
Object.getOwnPropertyNames(instance) 的返回列表里，绝不会出现任何以 # 开头的名称。
最关键的是，你无法通过任何标准反射 API 去读取私有访问器背后的 getter 或 setter 函数引用。

简而言之，“私有”即意味着“对外部不可观测”。试图用反射工具去探测，注定是徒劳的。

可行的替代方案：依赖类自身提供克隆能力

既然外部工具无能为力，那正确的思路是什么？答案是：将克隆能力内化，让类自己来负责。这通常意味着需要类主动提供支持，以下是几种经过验证的可靠模式：

实现一个 clone() 实例方法：在类的内部，你可以直接访问私有字段，从而安全地复制状态并构建一个新实例。
暴露受控的序列化接口：例如实现 toJSON() 或 toPlainObject() 方法，返回一个包含必要状态的数据快照，供外部进行安全的深克隆操作。
复用构造函数与初始化逻辑：通过相同的构造逻辑，让新实例能够基于原始实例的私有状态来重建自身。

来看一个具体的例子：

class Person {
  #name;
  #age;
  constructor(name, age) {
    this.#name = name;
    this.#age = age;
  }
  clone() {
    // ✅ 在类内部，可以直接访问私有字段，这是安全重建的唯一途径
    return new Person(this.#name, this.#age);
  }
  toJSON() {
    // ✅ 提供结构化的纯数据，方便外部进行深克隆
    return { name: this.#name, age: this.#age };
  }
}
const a = new Person("Alice", 30);
const b = a.clone(); // 完整克隆，包含所有私有状态
const c = Object.assign(new Person(), a.toJSON()); // 另一种方式，需确保构造函数能处理普通对象

对公有访问器 + 私有后备字段的组合处理

这是一种非常常见的封装模式：对外暴露公有的 getter/setter，但实际数据存储在私有字段中。对于这种情况，Object.getOwnPropertyDescriptors 可以派上用场，但只能解决一半的问题。

你可以用 Object.getOwnPropertyDescriptors(obj) 获取所有公有属性（包括访问器）的完整描述符。
然后，使用 Object.defineProperties({}, descriptors) 来创建一个具有相同公有接口的新对象骨架。
然而，最关键的私有字段值，描述符 API 依然无能为力。这部分状态仍然必须通过类内部的 clone() 方法或特定的构造参数来注入。

下面这个计数器示例清晰地展示了这种组合模式：

class Counter {
  #value = 0;
  get count() { return this.#value; }
  set count(v) { this.#value = Math.max(0, v); }
  clone() {
    const copy = new Counter();
    copy.#value = this.#value; // ✅ 这是写入私有字段的唯一合法方式
    return copy;
  }
}
const c1 = new Counter();
c1.count = 42;
const c2 = c1.clone(); // 正确克隆了私有的 #value

总结：不要尝试绕过私有性，而要设计可克隆的类

说到底，Ja vaScript 的私有特性并不是需要被“攻克”的障碍，而是一个明确的设计提示：对象的克隆逻辑，理应成为类契约的一部分。试图用反射去“破解”私有字段，不仅违背了封装的初衷，在技术上也是行不通的。

构建健壮代码的正确姿势是：

在类中明确定义克隆方法，如 clone()、copy()，或提供静态工厂方法如 from()。
在需要时，可以结合 structuredClone()（针对可序列化值）或 JSON.stringify/parse（针对纯数据）来处理对象的公有状态部分。
最重要的一点：避免在外部寻求一种能“通用克隆”所有含私有成员对象的银弹。没有这样的银弹，只有清晰的设计约定。