TypeScript中不重新实例化类为对象添加所有属性及方法

嘿，这个问题太常见了！我之前处理JSON转类实例的时候也踩过一模一样的坑——类型断言骗得了TypeScript编译器，但骗不了运行时，毕竟从JSON解析出来的就是个普通JS对象，根本没绑定类的方法对吧？

不用重新实例化，我们可以直接修改现有对象的原型链，把它的原型指向目标类的prototype，这样就能让对象继承类的所有方法。下面给你详细讲两种场景的实现：

1. 单个对象的快速转换 #

对于单个普通对象，直接用Object.setPrototypeOf()修改原型就行，一步到位：

class Item {
  id: number;
  name: string;

  constructor(id: number, name: string) {
    this.id = id;
    this.name = name;
  }

  getFullName(): string {
    return `Item ${this.id}: ${this.name}`;
  }
}

// 模拟从JSON获取的普通对象
const obj = { id: 1, name: "Test Item" };

// 关键一步：把obj的原型设置为Item的原型
Object.setPrototypeOf(obj, Item.prototype);

// 现在可以正常调用类方法了！
console.log(obj.getFullName()); // 输出 "Item 1: Test Item"

这样操作后，obj就拥有了Item类的所有原型方法，而且完全复用了原来的属性值，不需要重新创建实例。

2. 嵌套对象的通用映射函数 #

如果你的JSON里有嵌套的Item对象（比如父Item包含子Item），可以写一个递归函数批量处理所有嵌套对象：

/**
 * 把普通对象（含嵌套）映射为指定类的实例
 * @param obj 从JSON解析的普通对象
 * @param cls 目标类
 * @returns 绑定了类方法的对象
 */
function mapToClass<T>(obj: any, cls: new (...args: any[]) => T): T {
  // 先给当前对象绑定类原型
  Object.setPrototypeOf(obj, cls.prototype);

  // 递归处理嵌套的对象（可根据需求调整判断逻辑）
  for (const key in obj) {
    if (obj.hasOwnProperty(key) && typeof obj[key] === 'object' && obj[key] !== null) {
      // 这里默认嵌套对象也是同一个类的实例，你可以根据实际情况修改判断条件
      obj[key] = mapToClass(obj[key], cls);
    }
  }

  return obj as T;
}

// 使用示例：嵌套对象
const nestedObj = { 
  id: 2, 
  name: "Parent Item", 
  child: { id: 3, name: "Child Item" } 
};

const mappedItem = mapToClass(nestedObj, Item);

console.log(mappedItem.getFullName()); // 输出 "Item 2: Parent Item"
console.log(mappedItem.child.getFullName()); // 输出 "Item 3: Child Item"

几个注意事项 #

• 构造函数逻辑：这种方法不会执行类的构造函数，如果你的构造函数里有除了属性赋值之外的重要逻辑（比如初始化一些非JSON属性），那这个方法不适用，你可能需要结合构造函数做部分初始化。
• TypeScript类型提示：修改原型后，TypeScript可能还是会有类型报错，这时候用as T断言类型就好，或者在通用函数里已经处理了返回类型。
• 性能影响：Object.setPrototypeOf()的性能比直接创建实例略低，但对于大多数业务场景来说完全可以忽略，尤其是嵌套层级不深的情况。
• 不可扩展对象：如果你的对象是通过Object.freeze()或Object.preventExtensions()处理过的不可扩展对象，修改原型会报错，不过JSON解析出来的对象默认都是可扩展的，不用担心。

这种方式完美适配你不想遍历所有对象创建实例的需求，直接在现有JSON对象上绑定类方法，省心又高效～

内容的提问来源于stack exchange，提问作者Julian Adler