TypeScript增强tizen-tv-webapis接口后参数推断为any问题

问题原因 #

1. 接口重载冲突：第三方包原始的AVPlayPlaybackCallback接口中，ondrmevent方法的参数类型和你增强的类型会合并成重载列表。TypeScript在自动推断对象实现的参数类型时，无法确定匹配哪个重载，因此默认 fallback 到any类型。
2. 类型增强写法错误：如果你的模块/全局声明写法不符合TypeScript的类型扩展规则，增强后的类型可能没有被正确合并，导致推断时仍优先使用原始的宽泛类型。

解决办法 #

1. 修正类型增强写法（确保覆盖原始定义）

根据tizen-tv-webapis的类型暴露方式选择对应写法：

• 全局类型（如window.tizen）：
  在项目的类型声明文件（比如src/types/tizen.d.ts）中写：

  declare global {
    interface AVPlayPlaybackCallback {
      // 直接重写ondrmevent的类型，覆盖原始的object参数定义
      ondrmevent?(type: string, data: { name: string; message: string }): void;
    }
  }
  
  export {}; // 标记文件为模块，避免全局声明冲突
  

• 模块引入方式：

  declare module 'tizen-tv-webapis' {
    interface AVPlayPlaybackCallback {
      ondrmevent?(type: string, data: { name: string; message: string }): void;
    }
  }
  

2. 用类型别名绕过重载问题

如果接口合并的重载无法避免，直接创建一个移除原始方法、合并新类型的别名：

// 剔除原始ondrmevent定义，再合并增强后的类型
type EnhancedAVPlaybackCallback = Omit<AVPlayPlaybackCallback, 'ondrmevent'> & {
  ondrmevent?(type: string, data: { name: string; message: string }): void;
};

// 使用该别名定义对象，参数会自动推断正确类型
const playbackCallback: EnhancedAVPlaybackCallback = {
  ondrmevent(type, data) {
    // type 自动推断为 string，data 自动推断为 {name: string; message: string}
    console.log(data.name, data.message);
  }
};

3. 显式标注参数类型（临时快速方案）

在实现ondrmevent时手动标注参数类型，强制TypeScript使用增强后的类型：

const playbackCallback: AVPlayPlaybackCallback = {
  ondrmevent(type: string, data: { name: string; message: string }) {
    // 类型可被正确识别
  }
};

额外检查 #

确保tsconfig.json中包含了你的类型增强文件：

{
  "compilerOptions": {
    // 其他编译配置
  },
  "include": [
    "src/**/*",
    "types/**/*.d.ts" // 替换为你的增强文件所在目录
  ]
}

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