Skip to content

[v1.4] 引进 Persistent Frame,防止 MV3 Event Page 休眠#1230

Draft
cyfung1031 wants to merge 41 commits intoscriptscat:release/v1.4from
cyfung1031:pr-persistent-event-page-001
Draft

[v1.4] 引进 Persistent Frame,防止 MV3 Event Page 休眠#1230
cyfung1031 wants to merge 41 commits intoscriptscat:release/v1.4from
cyfung1031:pr-persistent-event-page-001

Conversation

@cyfung1031
Copy link
Collaborator

@cyfung1031 cyfung1031 commented Feb 11, 2026

概述

在 MV3 架构下,Event Page(類似Service Worker)会被浏览器自动休眠。本 PR 透过新增 persistent_frame 机制,使 Event Page 能持续保持活跃,不被浏览器中断。

问题背景

MV3 的 Event Page 在闲置一段时间后会被浏览器强制休眠,导致后台脚本无法持续执行,影响定时任务、长时间运行脚本等功能的稳定性。

解决方案

在 Event Page 中嵌入一个隐藏的 persistent_frame iframe:

  • iframe 独立线程持续 loop:不影响 Event Page 主线程性能
  • 定时触发心跳:当时间条件满足时,写入 storage.session
  • Event Page 监听唤醒信号:透过 storage.session 的 change event listener 接收心跳,保持自身活跃

附注

  • 此机制同样适用于 offscreen 实现,为全面迈入 Firefox MV3 支援铺路
  • iframe 运行于独立线程,不会拖慢浏览器或 Event Page 本身

@cyfung1031 cyfung1031 changed the title [v1.4?] MV3 Persistent Event Page [v1.4] MV3 Persistent Event Page Feb 24, 2026
@cyfung1031 cyfung1031 changed the base branch from release/v1.3 to release/v1.4 March 15, 2026 05:11
@cyfung1031 cyfung1031 changed the title [v1.4] MV3 Persistent Event Page [v1.4] MV3 防止 Event Page 休眠 (Persistent Event Page) Mar 22, 2026
@cyfung1031
Copy link
Collaborator Author

cyfung1031 commented Mar 22, 2026

等合并后再研究 unified persistent frame

mv3_unified_persistent_frame

@cyfung1031 cyfung1031 changed the title [v1.4] MV3 防止 Event Page 休眠 (Persistent Event Page) [v1.4] 引进 Persistent Frame,防止 MV3 Event Page 休眠 Mar 22, 2026
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