如何避免enumerable: false属性引发的TypeScript编译错误

以下是几个无需使用any或非空断言的解决方案：

1. 提前定义包含目标属性的接口 #

先声明一个包含salary的接口，再通过类型断言将初始对象转为该接口类型：

interface Person {
  name: string;
  salary?: number; // 标记为可选，因为属性是后续添加的
}

const person = { name: "Alice" } as Person;
Object.defineProperty(person, "salary", {
  value: 50000,
  enumerable: false,
  writable: true,
  configurable: true
});

console.log(person.salary); // 编译无报错，运行正常访问

这种方式类型清晰，适合需要复用类型的场景。

2. 用交叉类型扩展原有类型 #

如果不想提前定义接口，可以直接基于原有对象的类型，通过交叉类型合并新属性：

const person = { name: "Alice" };
Object.defineProperty(person, "salary", {
  value: 50000,
  enumerable: false,
  writable: true,
  configurable: true
});

// 交叉类型合并原有类型与{ salary: number }
const typedPerson = person as typeof person & { salary: number };
console.log(typedPerson.salary); // 编译正常

这种方式灵活，适合临时扩展单个对象的类型。

3. 封装泛型断言函数（自动推导类型） #

写一个泛型函数，利用asserts语法让TypeScript自动识别添加属性后的对象类型：

function defineProperty<T, K extends PropertyKey, V>(
  obj: T,
  key: K,
  descriptor: TypedPropertyDescriptor<V>
): asserts obj is T & Record<K, V> {
  Object.defineProperty(obj, key, descriptor);
}

const person = { name: "Alice" };
defineProperty(person, "salary", {
  value: 50000,
  enumerable: false,
  writable: true,
  configurable: true
});

console.log(person.salary); // 编译无报错，TS自动识别salary属性

这个函数可以复用，调用后无需手动断言，类型安全性更高。

4. 使用类封装（规范场景首选） #

如果业务场景允许，用类来定义对象，在构造函数中添加不可枚举属性，TypeScript会自动识别类的属性类型：

class Person {
  name: string;
  salary: number; // 类中声明属性，TS自动识别

  constructor(name: string) {
    this.name = name;
    Object.defineProperty(this, "salary", {
      value: 50000,
      enumerable: false,
      writable: true,
      configurable: true
    });
  }
}

const person = new Person("Alice");
console.log(person.salary); // 编译正常

类的方式更符合面向对象规范，适合需要创建多个同类型对象的场景。

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