类型安全的事件发射器实现思路

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《类型安全的事件发射器实现方法》，聊聊，希望可以帮助到正在努力赚钱的你。

答案是使用泛型和索引类型实现类型安全的 Event Emitter。通过定义 Events 接口明确事件名与参数类型，结合 TypedEmitter 泛型类约束 on、emit 方法的事件名和参数类型，确保编译时检查正确性，避免拼写错误或参数不匹配问题，提升代码健壮性。

实现一个类型安全的 Event Emitter，核心是让事件名称和对应的回调函数参数类型在编译时就能被正确约束。使用 TypeScript 可以通过泛型和索引类型来做到这一点，避免运行时因拼错事件名或传错参数导致的问题。

定义事件类型映射

先为所有可能触发的事件建立一个接口，键是事件名，值是该事件回调函数的参数类型数组。

interface Events {
  add: [number, number];
  error: [Error];
  message: [string, Date];
}

这样，监听 add 事件的回调必须接收两个 number 类型参数，而 error 事件只接受一个 Error 对象。

实现类型安全的 Emitter 类

使用泛型约束事件名必须是 Events 的 key，并确保 on、emit 等方法的参数与事件定义匹配。

class TypedEmitter<EventsMap> {
  private events = new Map<keyof EventsMap, Array<Function>>();

  on<K extends keyof EventsMap>(event: K, listener: (...args: EventsMap[K]) => void) {
    const listeners = this.events.get(event) || [];
    listeners.push(listener);
    this.events.set(event, listeners);
  }

  emit<K extends keyof EventsMap>(event: K, ...args: EventsMap[K]) {
    const listeners = this.events.get(event);
    if (listeners) {
      listeners.forEach(fn => fn(...args));
    }
  }

  off<K extends keyof EventsMap>(event: K, listener: (...args: EventsMap[K]) => void) {
    const listeners = this.events.get(event);
    if (listeners) {
      const index = listeners.indexOf(listener);
      if (index > -1) {
        listeners.splice(index, 1);
      }
    }
  }
}

这个类的关键在于用 EventsMap[K] 获取对应事件的参数类型元组，从而让 TypeScript 校验传参是否正确。

使用示例

将具体事件类型传入泛型，即可获得完整的类型提示和错误检查。

const emitter = new TypedEmitter<Events>();

emitter.on('add', (a, b) => {
  console.log(a + b); // 正确：a 和 b 是 number
});

emitter.emit('add', 1, 2); // ✅ 类型安全

// emitter.emit('add', '1', '2'); // ❌ 编译报错：类型不匹配

emitter.on('error', (err) => {
  console.error(err.message);
});

emitter.emit('error', new Error('Boom!')); // ✅ 正确

如果尝试监听一个不存在的事件名，TypeScript 也会立即报错。

基本上就这些。通过定义事件结构和合理使用泛型约束，就能在开发阶段捕获大多数事件相关的类型错误，提升代码健壮性。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~