这是一个自定义的事件发射器(Event Emitter)类,实现了 发布-订阅(Publish-Subscribe)模式 。它的主要作用是解耦各个模块(如播放器核心、UI、解码器),让它们通过事件进行通信,而不需要相互引用。
文件功能说明
该文件定义了一个 Emitter 类,包含以下核心方法:
- constructor (构造函数)
-
初始化 this.events 用于存储事件。
-
使用 Object.create(null) 创建一个 无原型的纯净对象 ,避免了与 Object.prototype 上的属性(如 toString )发生命名冲突,提高了安全性。
- on(name, fn, ctx) - 订阅事件
-
注册一个事件监听器。
-
参数 : name (事件名), fn (回调函数), ctx (上下文/this指向)。
-
特点 :包含类型检查,确保 fn 是函数;支持链式调用。
- once(name, fn, ctx) - 订阅一次性事件
-
注册一个只执行一次的监听器。
-
实现 :包装原始回调,在执行前先调用 off 移除自己。
- emit(name, ...args) - 发布/触发事件
-
触发指定名称的事件,并传递参数给所有订阅者。
-
关键特性(异步) :当前代码中使用了 Promise.resolve().then(...) 。这意味着事件回调是 异步执行 的(微任务)。
-
优点 :防止某个耗时的监听器阻塞当前的主线程执行流,提高页面响应性。
-
注意 : emit 调用后,回调不会立即执行,而是会在当前同步代码执行完毕后才执行。
- off(name, callback) - 取消订阅
-
移除事件监听器。
-
灵活性 :
-
不传参数:清空所有事件。
-
只传 name :移除该事件名下的所有监听器。
-
传 name 和 callback :移除特定的监听器(支持识别 once 包装过的函数)。
代码特点与潜在风险
这个实现相比原始版本做了很多优化(如参数检查、数组浅拷贝防止遍历时修改队列),但有一个显著特点需要注意:
- 异步微任务执行 :
代码中显式使用了 Promise.resolve().then 。这在处理 UI 通知或非关键逻辑时很好,但在某些需要 同步反馈 的场景下可能会导致问题。
- 例如 :如果你在 emit('changeData') 后立即读取数据,可能数据还没被监听器修改。