如何在TypeScript中为Boolean等原生对象添加自定义属性或方法？

实现方法 #

要达到和原生JS修改原型完全一致的使用效果，只需要额外补充类型声明合并的逻辑，告诉TS你给原生对象新增的属性/方法的类型定义即可，完整示例如下：

非模块环境（无import/export的顶层脚本） #

// 扩展全局Boolean接口，补充foo方法的类型定义
interface Boolean {
  foo: () => void
}

// 和原生JS完全一致的原型修改逻辑
Boolean.prototype.foo = function() {
  console.log(`I am boolean ${this}.`)
}

// 测试效果和原生JS完全一致
let truth = Boolean(true)
let lie = Boolean(false)

typeof truth // boolean
typeof lie // boolean

truth.foo() // I am boolean true
lie.foo() // I am boolean false

// 条件判断逻辑完全符合预期
if (lie) {
  console.log('这段内容不会执行')
}

模块环境（存在import/export的文件） #

需要把类型声明包在declare global块中，避免被识别为模块局部类型：

declare global {
  interface Boolean {
    foo: () => void
  }
}

Boolean.prototype.foo = function() {
  console.log(`I am boolean ${this}.`)
}

// 后续使用逻辑和上面完全一致

该操作是否推荐 #

非常不推荐在生产项目中使用这种方案，核心风险有三点：

• 原型污染风险：如果你自定义的方法名后续被ECMAScript官方纳入原生标准，你的自定义实现会直接覆盖原生方法，引发大规模兼容问题。
• 冲突风险：如果项目中多个依赖、公共库都对同一个原生原型做了同名方法扩展，会出现逻辑互相覆盖的问题，排查成本极高。
• 可维护性差：没有上下文的开发者不知道原生对象被修改过，遇到相关异常时很难定位根因。
  如果需要类似的能力更推荐两个替代方案：
• 编写独立的工具函数，比如function handleBooleanFoo(bool: boolean) { ... }，使用时传入布尔值即可，完全没有副作用。
• 可以用TS的 branded type 实现带自定义属性的布尔类型，全程不修改原生原型。

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