如何将类实例用作TypeScript中Record的键？

你希望将类实例作为Record<key, value>的键，但TypeScript的Record约束键只能是string | number | symbol类型，尝试Symbol.toPrimitive方法无法解决这个类型约束问题。

示例代码 #

class myTestClass{
  constructor(val: string) {
    this.value = val;
  }
  value:string;
  [Symbol.toPrimitive](hint: "number" | "string" | "default"): number | string {
    if (hint === "number") {
      return parseInt(this.value);
    }
    return this.value;
  }
}
export const MYRECORD: Record<myTestClass, someOther> = {};

报错信息 #

Type 'myTestClass' does not satisfy the constraint 'string | number | symbol'.   Type 'myTestClass' is not assignable to type 'symbol'.

可行解决方案 #

1. 使用Map（推荐）

TypeScript的Map原生支持任意类型作为键，包括类实例，完全匹配你的需求，不需要绕过类型约束：

class myTestClass {
  constructor(val: string) {
    this.value = val;
  }
  value: string;
}

// 定义Map的键类型为myTestClass，值类型为someOther
export const myInstanceMap = new Map<myTestClass, someOther>();

// 使用示例
const testInstance = new myTestClass("test");
myInstanceMap.set(testInstance, { /* someOther类型的实例 */ });
const targetValue = myInstanceMap.get(testInstance);

优点：原生支持实例作为键，类型安全，不会出现键冲突（只要实例引用不同），API更贴合需求。

2. 给实例分配唯一Symbol键

如果一定要使用Record，可以给每个类实例生成一个唯一的symbol属性，用这个symbol作为Record的键：

class myTestClass {
  constructor(val: string) {
    this.value = val;
    // 生成唯一symbol，可传入val作为描述（不影响唯一性）
    this.uniqueKey = Symbol(val);
  }
  value: string;
  readonly uniqueKey: symbol;
}

// Record的键类型为symbol，符合TypeScript约束
export const MYRECORD: Record<symbol, someOther> = {};

// 使用示例
const testInstance = new myTestClass("test");
MYRECORD[testInstance.uniqueKey] = { /* someOther类型的实例 */ };

优点：可以继续使用Record结构，每个实例对应唯一键，不会冲突。

3. 利用toString+类型断言（不推荐）

如果你的类实例有唯一的可序列化标识（比如value字段全局唯一），可以通过重写toString方法，结合类型断言绕过Record的类型约束，但存在键冲突风险：

class myTestClass {
  constructor(val: string) {
    this.value = val;
  }
  value: string;
  // 返回唯一标识字符串
  toString() {
    return this.value;
  }
}

// 类型断言为Record<string, someOther>
export const MYRECORD = {} as Record<string, someOther>;

// 使用示例
const testInstance = new myTestClass("test");
// 手动调用toString作为键
MYRECORD[testInstance.toString()] = { /* someOther类型的实例 */ };
// 或通过类型断言直接用实例当键（JS会自动调用toString）
MYRECORD[testInstance as unknown as string] = { /* someOther类型的实例 */ };

缺点：如果两个不同实例的value相同，会覆盖彼此的键值对，仅适用于实例标识绝对唯一的场景。

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