使用自定义类型触发Type error：TypeScript中trigger方法类型匹配问题求助

核心原因 #

这个报错的根源是TypeScript多态this类型的不确定性。

在类方法中使用this['eventMap']时，this代表的是当前类或其子类的实例类型。哪怕你在父类里用declare指定了eventMap的类型为ButtonEventMap，TypeScript仍然会保留子类重写eventMap的可能性——比如子类可以扩展事件类型、修改现有事件的结构。这种情况下，Omit<this['eventMap'][K], 'source'>的具体类型在父类中是无法被完全确定的，TypeScript没办法验证你传入的{data: 1}能适配所有可能的子类场景，因此抛出类型不匹配的错误。

当你把this替换成Button类名时，类型变成了确定的Button['eventMap']，TypeScript能直接解析出Omit<ButtonEventMap['click'], 'source'>就是{data: number}，自然就不会报错了。

至于ClickEvent不继承EventBase时Partial能正常工作，是因为此时事件类型结构更简单，不需要处理继承带来的字段剔除逻辑，多态this的不确定性对类型推导的影响被大幅弱化了。

解决方案 #

如果你想保留父类方法的通用性，同时避免子类重写的麻烦，可以采用以下两种方式：

1. 使用父类名代替多态this（简单直接）

直接在trigger方法中用Button['eventMap']代替this['eventMap']，让类型推导完全基于父类的确定类型：

interface EventBase {
  source: object;
}

interface ClickEvent extends EventBase {
  data: number;
}

interface ButtonEventMap {
  'click': ClickEvent;
}

class Button {
  declare eventMap: ButtonEventMap;

  // 用Button['eventMap']替代this['eventMap']
  trigger<K extends keyof Button['eventMap']>(type: K, event: Omit<Button['eventMap'][K], 'source'>) {
    // ...
  }

  click() {
    this.trigger('click', {
      data: 1
    });
  }
}

2. 泛型类实现子类扩展支持（兼顾通用性）

如果需要支持子类自定义eventMap，可以把类改成泛型结构，让eventMap的类型由泛型参数确定，避免多态this的不确定性：

interface EventBase {
  source: object;
}

interface ClickEvent extends EventBase {
  data: number;
}

interface ButtonEventMap {
  'click': ClickEvent;
}

// 泛型类，默认使用ButtonEventMap，子类可传入自定义事件映射
class Button<T extends Record<string, EventBase> = ButtonEventMap> {
  declare eventMap: T;

  trigger<K extends keyof T>(type: K, event: Omit<T[K], 'source'>) {
    // 内部可以自动给event补充source字段，比如：
    const fullEvent = { ...event, source: this } as T[K];
    // 触发逻辑...
  }

  click() {
    // 泛型默认值下可直接推断类型，无需额外断言
    this.trigger('click', { data: 1 });
  }
}

// 子类示例：扩展事件类型
interface ExtendedButtonEventMap extends ButtonEventMap {
  'hover': { source: object; x: number; y: number };
}

class ExtendedButton extends Button<ExtendedButtonEventMap> {
  hover() {
    this.trigger('hover', { x: 10, y: 20 });
  }
}

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