chrome.tabs.executeScript仅在活动标签页执行的问题排查与解决

看起来你遇到的核心问题是：明明监听了标签页更新事件，但脚本却只在活动标签页生效，非活动标签页完成加载时没触发注入。我来帮你拆解一下问题，并给出可行的解决方案。

首先澄清一个关键点 #

你代码里的tabId参数确实就是完成更新的那个标签页的ID，不是当前活动标签页的。那为什么会出现只在活动标签页运行的情况？大概率是chrome.tabs.onUpdated的触发机制不够精准，或者你的脚本逻辑依赖了标签页的活动状态。

更可靠的解决方案：使用webNavigation.onCompleted API #

相比tabs.onUpdated（会在标签页状态变化时多次触发，比如loading、complete），webNavigation.onCompleted会在页面完全加载完成时精准触发一次，而且不管标签页是否处于活动状态，都能正确捕获事件。

修改你的background.js代码如下：

// 监听所有标签页的页面加载完成事件
chrome.webNavigation.onCompleted.addListener(function(details) {
    // 可选：只在目标网站注入脚本，替换成你的目标URL规则
    if (details.url.includes("your-target-website.com")) {
        // 向完成加载的标签页注入脚本
        chrome.tabs.executeScript(details.tabId, { file: 'inject.js' }, function() {
            // 注入失败时打印错误日志，方便调试
            if (chrome.runtime.lastError) {
                console.error("脚本注入失败：", chrome.runtime.lastError.message);
            }
        });
    }
}, {
    // 配置监听的URL范围，和你的权限保持一致
    url: [
        { urlMatches: "https://*/*" },
        { urlMatches: "http://*/*" }
    ]
});

为什么这个方法更有效？ #

1. 精准触发：webNavigation.onCompleted只会在页面所有资源加载完成后触发一次，不会像tabs.onUpdated那样多次回调导致混淆。
2. 跨标签页生效：无论标签页是否处于活动状态，只要页面加载完成，就会触发注入，完全符合你的需求。
3. 内置URL过滤：可以通过配置url参数提前过滤目标网站，避免给所有页面注入脚本，提升扩展性能。

额外的排查要点 #

如果替换API后还是有问题，建议检查这两点：

• 检查inject.js的逻辑：看看你的自动化流程代码里有没有类似if (document.hasFocus())的判断——如果有，那即便是脚本注入到了非活动标签页，也会因为标签页未聚焦而不执行逻辑，去掉这个判断即可。
• 调试标签页ID：在回调里打印details.tabId和details.url，确认触发事件的是你预期的那个非活动标签页：

  console.log("完成加载的标签页：ID=", details.tabId, "URL=", details.url);
  

你的manifest配置已经包含了webNavigation权限，不需要额外修改，直接替换background.js的代码即可。

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