跳转至

[ISSUE-0179] 守卫监听了一个不会发生的事件

现象

chrome://extensions 错误面板,第四次出现同一族报错:

Blocked aria-hidden on an element because its descendant retained focus.
Element with focus: <div.MuiDataGrid-cell MuiDataGrid-cell--textLeft>
Ancestor with aria-hidden: <div#root>

另一条形态是 Drawer 自己:焦点在 .MuiDrawer-paper,aria-hidden 在 .MuiDrawer-root。

病灶:监听错了事件

真实的事件顺序是:

焦点早就在 DataGrid cell 上(用户点过表格)
  → 打开弹层
  → MUI 给 #root 加 aria-hidden
  → Chrome 报错

焦点从头到尾没有变化,变的是属性。 而 focus-guard 从 v0.14.2 起监听的是 focusin ⇒ 一次都不触发。

⚠️ 这条守卫此前有过三个版本(绑组件 → 绑打开时刻 → 绑全局 focusin), 每次都在讨论「绑在哪个路径上」,没有人问过「这个事件真的会发生吗」。 v0.14.2 的注释还写着「不认路径,只认状态」—— 方向是对的, 但它认的那个「状态」是靠 focusin 取的,而那个事件根本不来。

修法

补第二条腿:MutationObserver 监听 aria-hidden 属性变化, 命中且内部持有焦点时 blur。

🔴 两条腿都要留: - focusin 管「焦点主动移进已经 hidden 的子树」 - MutationObserver 管「焦点不动、aria-hidden 罩上来」

成因不同,缺一条漏一类。

⚠️ 已知局限(不重复「修法没被证明有效」那个错)

MutationObserver 是 microtask,而 Chrome 的检查在属性写入时同步发生 ⇒ 首次仍会报一条。本守卫消除的是其后的重复与残留焦点。

要彻底不报,得让 MUI 别给 #root 加 aria-hidden(Chrome 建议改用 inert, MUI v5.15 没有该选项)—— 那是升级 MUI 或改 Modal 容器的事,不在本刀范围。

验证方法(给使用者)

🔴 chrome://extensions 的错误面板不会因重载而清空。 判断「还报不报」必须: 1. 点「全部清除」 2. 刷新扩展 3. 复现操作(点表格 → 开弹层) 4. 再看面板

不做第 1 步的话,看到的可能全是历史条目。

判据

tests/focus-guard-coverage.test.ts:必须有 MutationObserver + attributeFilter: ['aria-hidden'] + subtree: true,且 focusin 那条腿不许被删。 三条变异(去掉 observer / 去掉 subtree / 改掉 focusin)全部验红。