第72章 观察者模式

题目:观察者模式——事件订阅发布器

实现一个轻量级事件总线,支持事件的订阅、发布与取消订阅。通过 TypeScript 泛型约束事件类型,保证事件名与回调参数的类型安全。

设计思路

使用一个Map存储事件名到回调函数数组的映射。每次触发事件时,遍历执行对应回调。利用泛型 Record<string, unknown[]> 定义事件表,通过 keyof 约束事件名,实现类型安全的 on 与 emit 方法。

核心代码

// 事件订阅发布器
class EventBus<T extends Record<string, unknown[]>> {
  private events: Map<keyof T, Set<Function>> = new Map();

  // 订阅事件
  on<K extends keyof T>(event: K, callback: (...args: T[K]) => void) {
    if (!this.events.has(event)) {
      this.events.set(event, new Set());
    }
    this.events.get(event)!.add(callback);
    return () => this.off(event, callback);
  }

  // 取消订阅
  off<K extends keyof T>(event: K, callback: Function) {
    this.events.get(event)?.delete(callback);
  }

  // 发布事件
  emit<K extends keyof T>(event: K, ...args: T[K]) {
    this.events.get(event)?.forEach(cb => cb(...args));
  }
}

// 定义事件表
type AppEvents = {
  userLogin: [username: string, id: number],
  orderPlaced: [orderId: string]
};

// 使用示例
const bus = new EventBus<AppEvents>();
const unsub = bus.on('userLogin', (name, id) => console.log(`登录:${name} (${id})`));
bus.on('orderPlaced', (orderId) => console.log(`订单:${orderId}`));

bus.emit('userLogin', '张三', 1001);
bus.emit('orderPlaced', 'ORD-2024');
unsub();  // 取消订阅
bus.emit('userLogin', '李四', 1002);

运行结果

依次输出:
登录:张三 (1001)
订单:ORD-2024

李四的登录消息被取消订阅,不会输出。

测试建议

使用 ts-node 直接运行,或编译后执行。观察取消订阅后的行为。

注意事项

回调使用 Set 存储,可自动过滤重复注册;但需注意闭包引用导致的旧回调保留问题。

成功要点

泛型 + keyof 使得事件名拼写错误在编译期即被拦截,传播参数类型自动推导。

常见问题

若发布时事件尚未被订阅,不会报错,仅默默忽略;如需检测可增加日志逻辑。