[ISSUE-0178] 旧 content script 的临终噪音¶
现象¶
Tony 2026-09-19 截图,chrome://extensions 错误面板:
Uncaught (in promise) Error: Extension context invalidated.
上下文 https://www.google.com/maps/search/water%20sports%20equipment%20rental%20service,+Parker,+ID
堆叠追踪 content-scripts/content.js:165(匿名函数)
成因¶
扩展一 reload(开发期刷新、或商店自动更新),旧的 content script 仍然活在已经打开的页面上, 但它持有的 chrome API 句柄已经作废。它下一次碰 storage / sendMessage 就抛这个错。
⚠️ 这不是「扩展坏了」,但它看起来就是 —— 用户打开错误面板只看到一串红。
为什么不能复用 ext-context-guard¶
那一套(ISSUE-0022 / 0052)的收尾动作是 location.reload():
对扩展自己的页面(main / popup / settings)是对的,重载就拿到新 context。
但 content script 跑在用户的 Google Maps 页面上 —— reload 会把用户正在看的地图、正在跑的搜索结果一起刷掉。那是破坏性的。
修法¶
新建 src/utils/content-context-guard.ts,只做两件事:
unhandledrejection里识别 context 失效家族,preventDefault()不让它冒成 uncaughtconsole.debug留一条能看懂的痕
WXT 的 ctx 本来就会在 invalidate 时自动卸载我们注入的 UI ——
按钮消失本身就是「该刷新这一页了」的信号,不需要额外打扰用户。
两个约束,方向相反、缺一不可¶
① 判定必须窄。 只认三种措辞(Extension context invalidated /
Receiving end does not exist / message port closed)。
放宽成「所有 chrome 相关错误」会把真 bug 一起吞掉 ——
而被吞掉的真 bug 是查不出来的,比噪音危险得多。
② 留痕只能用 debug。
chrome://extensions 的错误面板收集 warn 和 error。
用那两级留痕 = 一边消音一边制造同样的噪音。
🔄 v0.14.3 在 focus-guard 上踩过一模一样的坑:守卫「修好了」,
但留痕用 warn,于是用户在错误面板里照样看到一片红。
必须 import-time 自启¶
挂在 src/entrypoints/content/index.tsx 的第一行。
ISSUE-0052 的教训:等到 main(ctx) 里才装 listener,
import 阶段(injectScript / RequestInterceptors / storage 初始化)
产生的 rejection 就漏在 listener 之前,照样冒进错误面板。
判据¶
tests/content-context-guard.test.ts 6 条(3 条变异全部被抓):
认得出三种措辞 + 字符串形态的 reason;误吞检测(8 个无关错误一个都不许认);
不许 reload;不许用 warn/error 留痕;必须顶层自启且是入口第一个 import。