Skip to content

fix(core): 降级保活恢复事件监听时与原生语义对齐(区分 capture、once 触发后不再恢复) - #1120

Merged
yiludege merged 1 commit into
masterfrom
fix/event-listener-cache
Nov 14, 2026
Merged

yiludege merged 1 commit into
masterfrom
fix/event-listener-cache

Conversation

@yiludege

Copy link
Copy Markdown
Collaborator

背景

#997 修复了降级 + 保活模式下 removeEventListener 误删缓存的问题。但缓存识别监听时只看 type + handler,和浏览器原生语义(type + handler + capture,以及 once 触发后自动移除)不一致。切走再切回、恢复监听后,以下场景的行为和原生不同:

场景 原生 修复前
once 监听触发后切回再点击 不再触发 再次触发,每切一次就多触发一次
同一 handler 同时绑定 capture 和 bubble 两个都恢复 只恢复一个
绑定 capture 和 bubble 后移除 capture bubble 仍然触发 两个都不再触发

修改

  • recordEventListeners:以 type + handler + capture 识别同一个监听,options 无论是布尔值还是对象,都统一归一化为 capture 后比较。
  • 对 once 监听,额外注册一个内部的 { once, capture } 清理监听,事件触发时删除对应的缓存记录;不包装业务回调。清理监听注册在业务监听之前:业务监听被更早的 stopImmediatePropagation 拦截时(原生不会消耗这次 once),清理也不会执行,缓存记录得以保留。
  • once 监听在触发前被 removeEventListener 移除时,一并移除内部清理监听。
  • recoverEventListeners / recoverDocumentListeners 恢复监听时,会重新注册 once 的清理监听,保证多次切换后行为一致。
  • 新增 EventListenerRecord 类型,替换三处重复的内联类型。

验证

  • 新增单测 __test__/unit/event-listener-cache.test.ts(6 个用例):修复前全部失败,修复后全部通过。
  • 在 Chrome 中按降级 + 保活场景连续切换三轮,点击计数与原生预期一致:
    • 修复前:{once:1,both:2,captureRemoved:1} → {once:2,both:3,captureRemoved:1} → {once:3,both:4,captureRemoved:1}
    • 修复后:{once:1,both:2,captureRemoved:1} → {once:1,both:4,captureRemoved:2} → {once:1,both:6,captureRemoved:3}

Follow-up of #997

- 以 type + handler + capture 识别监听,同一 handler 的 capture/bubble 分别记录与移除
- once 监听触发后同步清理缓存记录,切回后不再重新绑定;触发前被移除时一并移除内部清理监听
- 恢复监听时重新注册 once 的清理监听,多次切换后行为保持一致

Co-authored-by: Cursor <cursoragent@cursor.com>
@yiludege
yiludege merged commit 0bda67c into master Nov 14, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant