如何让TypeScript识别外部类通过原型定义的额外属性？

当然可以，以下几种方法能让TypeScript识别这些原型上的属性：

• 扩展类的接口声明
  这是最常用的方式，通过声明文件补充缺失的类型。在项目里新建一个.d.ts文件（比如global.d.ts），根据库的模块情况补充类型：
  如果库是模块化的：

  declare module '你的外部库名称' {
    interface ClassName {
      // 按实际情况添加原型属性/方法的类型
      extraProperty: string;
      extraMethod: (param: number) => void;
    }
  }
  

  如果类是全局暴露的：

  declare global {
    interface ClassName {
      extraProperty: string;
    }
  }
  export {}; // 必须加上这句，让文件被识别为模块
  

• 用类型断言临时处理
  如果只是少数地方用到这些属性，直接用类型断言告诉TypeScript属性存在：

  const instance = new ClassName();
  // 直接断言包含目标属性
  (instance as ClassName & { extraProperty: string }).extraProperty = "test";
  
  // 或者先定义一个扩展类型再断言
  type ExtendedClassName = ClassName & {
    extraProperty: string;
    extraMethod(): void;
  };
  const typedInstance = instance as ExtendedClassName;
  typedInstance.extraMethod();
  

• 手动编写完整类型定义文件
  如果库的类型缺失严重，完全可以自己写一份.d.ts文件来覆盖或补充。比如：

  // custom-lib.d.ts
  declare class ClassName {
    constructor(/* 填写构造函数的参数类型 */);
    // 构造函数里定义的属性
    builtInProp: number;
    // 原型上的属性和方法
    extraProp: string;
    extraMethod(arg: string): boolean;
  }
  
  export { ClassName };
  

  之后在tsconfig.json的include数组里加上这个文件，确保TypeScript能读取到。

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