[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。
病灶:监听错了事件¶
真实的事件顺序是:
焦点从头到尾没有变化,变的是属性。
而 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)全部验红。