打开预览,关掉,再打开。下一次更新触发了两次回调。重启应用后恢复正常,但重复这组操作,问题又会出现。先别急着改事件发送端,看看第一次打开的预览留下了什么。

假设多个预览共用一个事件总线,总线比单次预览活得更久。用一个小的 Node.js 示例就能模拟打开和关闭,不需要渲染窗口。要查清的是:每一步结束后,还剩哪些订阅。

在一次重开前后数清订阅

重开后只发送一次 change,同时记录监听器数量和收到更新的视图:

步骤 错误实现的监听器数 修复后的监听器数
打开前 0 0
打开第一个视图 1 1
关闭第一个视图 1 0
打开第二个视图 2 1
发送一次事件 第一、第二个视图都收到 只有第二个视图收到

最早出错的是关闭第一个视图的那一步。它的订阅本应在这里消失。只盯着更新处理函数,会错过更早发生的问题。

示例用 listenerCount('change') 读取数量,emit 同步调用回调。不需要定时器,也不需要连续点击,就能复现重复投递。

追踪函数引用,而不是函数长相

下面的挂载函数有缺陷。它返回一个函数,调用方应在视图关闭时执行:

export function mountUnsafeView(bus, publish) {
  bus.on('change', (value) => publish(value));
  return () => bus.off('change', (value) => publish(value));
}

传给 on 和传给 off 的箭头函数长得一样,但两个表达式分别创建了新的函数对象。清理时找的是新对象,原来的订阅还留在总线上。第一个回调也仍然能访问第一次传入的发布函数。

Node 把 off 定义为 removeListener 的别名,后者移除指定监听器。这里应核对 Events API 文档。在这个 EventEmitter 示例中,事件名和回调函数体相同还不够,清理时必须拿到注册时的函数引用。

每次挂载返回自己的清理函数

把回调保存一次,让清理闭包持有同一个引用:

export function mountView(bus, publish) {
  const onChange = (value) => publish(value);
  bus.on('change', onChange);
  let disposed = false;
  return function dispose() {
    if (disposed) return;
    disposed = true;
    bus.off('change', onChange);
  };
}

每次挂载都创建独立的 onChange。返回的 dispose 移除这一次挂载的订阅,后续重复调用直接返回。标记明确了重复清理的行为,独立回调引用则区分了不同挂载。

即使两个视图收到相同的 publish 函数,各自的包装函数也让订阅保持独立。如果两个视图都把 publish 直接传给 on,同一个函数会注册两次,一次 off 只移除其中一份,最后一个复现测试演示了这种情况。返回的清理函数要由创建它的视图保存;如果关闭前被丢掉或覆盖,修正后的函数也不会自己退出订阅。

让其他订阅者在场,再测清理

关闭一个空总线上的视图后,检查监听器数为零,很有用,但还不够。如果改成调用 removeAllListeners,这条测试也会通过,却会让共用总线的其他订阅者一起失去更新。

因此,示例先注册一个独立观察者,再打开旧视图、关闭旧视图、打开新视图,并再次调用旧视图的清理函数。随后发送更新,检查究竟是谁收到:

检查时机 应有结果
再次清理旧视图后发送更新 观察者和新视图收到
新视图连续关闭两次后发送更新 只有观察者收到
两个视图共用发布函数,关闭其中一个 另一个仍收到更新
连续打开、关闭三轮 每次打开时收到一次,关闭后不再收到

这些断言同时检查数量和实际接收者。只看到还剩一个监听器,分不清它是观察者还是不该存活的旧视图。在新视图挂载后再调用旧 dispose,还可以发现清理函数错误访问共享可变状态的问题。

沿真实调用方读到退出路径

阅读陌生代码时,也按这个顺序走:

  1. 找到事件总线的创建位置,确认它是否跨导航存活,还是只属于一个视图。
  2. 找到每个订阅位置,检查打开、渲染、重新连接各自会走到这里多少次。
  3. 从注册追到移除,核对完整的回调引用。
  4. 找到 mountView 的调用方,看它把返回函数存在哪里。
  5. 沿相关退出路径找到 dispose 的调用,包括替换视图和初始化失败的路径。

在每个注册点旁边记下由哪个对象保存订阅、何时清理。“有清理函数但没有调用”与“调用时传错引用”,需要不同的修法。如果回调还启动异步工作,要继续追下去:移除订阅不会撤销已经开始的操作。追踪异步界面状态讨论了接下来这一步。

运行示例,确认适用范围

下载 event-listener-lifecycle.mjs,用 Node.js 22 或更新版本运行:

node --test event-listener-lifecycle.mjs

五个测试全部通过。两个名称带 reproduce: 的测试故意断言错误结果:重开后仍有旧订阅,以及同一回调注册两次、移除一次后仍有订阅。其余三个检查清理、重复调用和独立订阅者。不需要依赖或定时器。

这个练习用 EventEmitter 模拟视图生命周期,没有实现浏览器,也不保证 DOM EventTarget 行为完全相同。每次挂载只注册一次,清理发生在两次事件发送之间。事件发送过程中移除、框架副作用机制,以及取消已经开始的工作,都要按实际 API 另行检查。

在 Yenpo 里,可以先同时打开入口文件和清理文件,沿两处保存的回调引用继续读。