TypeScript继承JavaScript类时出现TS2554构造函数参数错误

报错原因 #

你碰到的TS2554错误，核心是TypeScript没法自动识别JavaScript父类AbstractPartnerInstance的构造函数需要参数。因为父类用了ES2022的私有字段#partner，TS对纯JS文件的类型推断在处理这种私有语法时存在局限——它看不到父类构造函数需要接收partner参数，就默认判定父类构造函数是无参的，子类继承后自然也被当成无参构造，你传参时就触发了错误。

解决方案 #

方法1：给第三方库添加类型声明文件 #

如果这个JS库是第三方依赖，你可以手动编写类型定义文件，明确告诉TS父类的结构：

在项目中创建@types/lib/index.d.ts文件（也可放在项目根目录的types文件夹下）：

declare module 'lib' {
  export class AbstractPartnerInstance {
    constructor(partner: any); // 可根据实际业务替换any为具体类型
    get data(): any;
    static schema(partner: any): Promise<void>;
    static version: any;
  }
}

然后在tsconfig.json中配置类型文件路径，让TS能识别到它：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./types"]
  }
}

方法2：在子类中显式定义构造函数 #

直接在TS子类里手动写构造函数，明确接收参数并传递给父类的super调用，让TS识别到子类构造函数的参数要求：

import { AbstractPartnerInstance } from 'lib';

class PartnerInstance extends AbstractPartnerInstance {
  constructor(partner: any) {
    super(partner); // 将参数传递给父类构造函数
  }

  static get version(): any {
    return 2;
  }
}

const test = new PartnerInstance('af'); // 此时不再报错

额外方案：若父类是自维护JS代码 #

如果这个JS父类是你自己写的，可以给它添加JSDoc注释，帮助TS自动推断类型：

/**
 * @param {any} partner 传入的partner参数
 */
constructor(partner) {
  this.#partner = partner;
}

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