0

0

如何实现一个类型安全的Event Emitter?

夜晨

夜晨

发布时间:2025-09-26 12:52:02

|

785人浏览过

|

来源于php中文网

原创

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

如何实现一个类型安全的event emitter?

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

定义事件类型映射

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

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

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

实现类型安全的 Emitter 类

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

class TypedEmitter {
  private events = new Map>();

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

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

  off(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 校验传参是否正确。

XpZC新普众筹系统
XpZC新普众筹系统

XpZC新普众筹系统是以asp.net mvc+sql进行开发的众筹网站源码。新普众筹系统可以实现众筹平台的快速搭建,规范业务流程、项目募集资金、运营风险控制、资金支付结算、项目实施控制、投后管理,安全的软件系统架构和规范的项目风险控制体系,为投融资双方提供安全优质的服务,达成互利共赢。众筹类型可选择股权众筹和回报众筹;根据客户实际需求能灵活增加系统功能模块,致力于为项目人和投资人搭建一个安全、高

下载

使用示例

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

const emitter = new TypedEmitter();

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 也会立即报错。

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

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

188

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

288

2023.10.25

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1050

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

106

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

458

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

11

2026.01.19

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

9

2026.01.22

html编辑相关教程合集
html编辑相关教程合集

本专题整合了html编辑相关教程合集,阅读专题下面的文章了解更多详细内容。

53

2026.01.21

三角洲入口地址合集
三角洲入口地址合集

本专题整合了三角洲入口地址合集,阅读专题下面的文章了解更多详细内容。

28

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
TypeScript 教程
TypeScript 教程

共19课时 | 2.4万人学习

TypeScript——十天技能课堂
TypeScript——十天技能课堂

共21课时 | 1.1万人学习

TypeScript-45分钟入门
TypeScript-45分钟入门

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号