[BUG] ...特定網頁無法翻譯

[thomasho18]

1. Environment / 运行环境

• OS / 操作系统: Windows 11 25H2
• Browser / 浏览器: Firefox 152.0.5
• Software Type / 软件类型: 擴展
• Version / 版本号: 2.0.28
• Script Manager / 脚本管理器: 無

2. Description / 问题描述
   https://docs-cortex.paloaltonetworks.com/home
   此網站下的頁面都無法整頁翻譯

3. Steps to Reproduce / 复现步骤

4. Screenshots / 截图 (Optional / 可选)
   If applicable, add screenshots to help explain your problem.
   如果有截图，请在此处添加，以便更直观地说明问题。

[fishjar]

这个网页内容在shadowroot里面，需要点开”扫描全部节点“

[thomasho18]

我點開了，但是還是無法翻譯?

我在全域設定也把"掃描shadowroot"也打開了，但是還是無法翻譯?

[fishjar]

[thomasho18]

我有試過打開，也有試過在頁面滑鼠按右鍵選單內選擇翻譯，但都還是無法
您那邊測試是可以的?

[Graceth1020]

我有試過打開，也有試過在頁面滑鼠按右鍵選單內選擇翻譯，但都還是無法 您那邊測試是可以的?
跟着作者的配置，看着可以正常翻译，可以再检查下你的插件配置

[thomasho18]

我剛用Edge，是可以翻譯的

但我是用Firefox，同樣的設定，就不能翻譯了......

[Graceth1020]

我剛用Edge，是可以翻譯的

但我是用Firefox，同樣的設定，就不能翻譯了......

Firefox这个页面扫描所有节点时报错，经Claude排查发现，translator.js文件中，`this.#textSheet` 这个 `CSSStyleSheet` 是在内容脚本的隔离作用域中创建的。Firefox 的 `adoptedStyleSheets` setter 会检查该样式表是否与目标 `ShadowRoot` 属于同一文档上下文。内容脚本的样式表与页面 ShadowRoot 来自不同的全局，Firefox 拒绝赋值并抛错。

经过修复后，可以正常显示。

以下为claude分析结果：

根因总结

问题根因

在 translator.js 中，当页面有 Shadow DOM 元素时（docs-cortex.paloaltonetworks.com 这类文档站大量使用 Web Components），开启 scanAll 后代码会遍历所有 ShadowRoot 并调用 #injectSheet()：

Firefox 内容脚本（MV2）与 Chrome 内容脚本（MV3）的一个关键差异：

	Chrome MV3	Firefox MV2 (152)
CSSStyleSheet()	✅ 内容脚本中可正常构造	✅ 可构造
sheet.replaceSync(text)	✅ 正常	✅ 正常
shadowRoot.adoptedStyleSheets = [..., sheet]	✅ 允许跨全局	❌ 抛 SecurityError / TypeError

this.#textSheet 这个 CSSStyleSheet 是在内容脚本的隔离作用域中创建的。Firefox 的 adoptedStyleSheets setter 会检查该样式表是否与目标 ShadowRoot 属于同一文档上下文。内容脚本的样式表与页面 ShadowRoot 来自不同的全局，Firefox 拒绝赋值并抛错。

当 scanAll 被切到 ON 时：

1. #init() → #findAndObserveShadowRoot()
2. #findAllShadowRoots(document.body) 遍历页面上所有元素 → 发现自定义元素的 ShadowRoot
3. #startObserveShadowRoot(shadowRoot) → #injectSheet(shadowRoot) ← 崩溃点
4. 错误传播到 msg.js 的 sendTabMsg，因 Firefox 错误信息不匹配 sendTabMsg 的 catch 过滤，最终弹出 JS 错误

修复做了什么

三层防御：

1. #createTextStyles() — 对 new CSSStyleSheet() + replaceSync() 加了 try-catch，如果构造失败则 #textSheet = null。同时提前保存纯文本 CSS 到 #textStylesRaw 供回退使用。

2. #injectSheet() — 不再裸写 adoptedStyleSheets 赋值，而是用 try-catch 包裹；捕获到异常后调用 #injectSheetFallback() 回退方案：在 ShadowRoot 内创建 <style> 内联元素，写入原始 CSS 文本。这绕过了 Firefox 的跨全局限制。

3. #startObserveShadowRoot() — 整体外层 try-catch，防止任何单个 ShadowRoot 的处理失败破坏整个扫描循环。

这样不管 Firefox 的 CSSStyleSheet / adoptedStyleSheets 表现如何，样式都能正确地注入到 Shadow DOM 中。

[fishjar]

@Graceth1020 能否提交一个修复此问题的PR？

[Graceth1020]

@Graceth1020 能否提交一个修复此问题的PR？

@fishjar 大佬，代码已提交，请帮忙review，若无问题，我提交PR
Graceth1020@4230a1e

[fishjar]

@fishjar 大佬，代码已提交，请帮忙review，若无问题，我提交PR Graceth1020@4230a1e

建议：把 prepend(style) 改为 append(style)

[Graceth1020]

@fishjar 大佬，代码已提交，请帮忙review，若无问题，我提交PR Graceth1020@4230a1e

建议：把 prepend(style) 改为 append(style)

已修改并提交PR，请大佬审核