Chrome扩展document_start注册window点击事件部分页面失效问题

问题场景 #

开发Chrome扩展时，通过document_start阶段自动注入content script，给window注册了捕获阶段的click事件，多数页面（如Stack Overflow）点击能正常触发事件，但部分页面（如Chrome应用商店的Google翻译扩展页面）点击无响应。即使改为document_idle阶段注入，问题仍存在。

配置与代码 #

manifest.json #

{
    "manifest_version": 3,
    "name": "Test",
    "version": "1.0.0",
    "description": "Test extension",
    "content_scripts": [
        {
            "matches": [
                "https://*/*",
                "http://*/*"
            ],
            "js": [
                "content_script.js"
            ],
            "all_frames": true,
            "run_at": "document_start",
            "match_about_blank": true
        }
    ],
    "permissions": [
        "activeTab",
        "tabs",
        "webNavigation"
    ],
    "host_permissions": [
        "https://*/*",
        "http://*/*"
    ]
}

content_script.js #

console.log('create global mouse handler');

window.addEventListener(
    'click',
    (e) => {
        console.log('click!');
    },
    true,
);

'1';

失效原因分析 #

• Shadow DOM隔离机制：Chrome应用商店的扩展详情页大量使用Shadow DOM封装组件。你的content script注入在主文档的window上下文，而Shadow DOM内部元素的点击事件默认不会冒泡到主文档（除非组件显式设置composed: true），导致主window的捕获事件无法监听到内部点击。
• 事件传播被主动阻止：部分页面的脚本可能在事件捕获或冒泡阶段调用了e.stopPropagation()或e.stopImmediatePropagation()，提前终止事件传播链。即使你的事件注册在捕获阶段，若页面在更早的捕获节点（如document）阻止了传播，你的监听函数也无法触发。
• 特殊页面的沙箱限制：Chrome应用商店属于Google的受控页面，部分内部iframe可能设置了严格的sandbox属性，限制了content script的事件监听能力，即使开启all_frames: true也无法突破这类限制。

内容的提问来源于stack exchange，提问作者trihai3012