如何在Chrome MV3扩展的UserScripts API中为特定TabID应用动态用户脚本

我完全懂你的困扰——Chrome 120 Beta刚推出的User Scripts API确实没提供直接通过tabID指定目标标签页的能力，只能靠URL匹配，这在多个标签页打开同一URL的场景下根本不顶用，刚好你说的内容脚本发消息给后台、再给对应tab加脚本的需求，我给你整理了一个可行的方案：

核心思路 #

因为UserScripts API本身不支持tabID参数，我们可以用URL匹配缩小范围 + 后台验证标签页ID的组合方式来实现精准定位：

1. 后台收到内容脚本的消息时，先记录目标tab的ID和当前URL
2. 注册用户脚本时，用目标tab的URL作为matches规则
3. 在用户脚本的代码里，先向后台发送验证请求，只有确认当前tabID和目标ID匹配时，再执行核心逻辑
4. 脚本执行完成后可以主动注销，避免影响其他同URL的标签页

具体代码实现 #

1. 内容脚本（触发请求）

当你需要给当前tab应用脚本时，发送消息通知后台：

// 内容脚本中触发
chrome.runtime.sendMessage({ action: "applyTargetUserScript" }, (res) => {
  console.log(res.msg);
});

2. 后台脚本（处理逻辑 + 注册验证）

后台负责接收消息、记录目标tab信息、注册脚本并完成ID验证：

// 后台脚本
let targetTabId = null;
let tempScriptUniqueId = null;

// 监听内容脚本的消息
chrome.runtime.onMessage.addListener(async (message, sender, sendResponse) => {
  // 处理"应用脚本"的请求
  if (message.action === "applyTargetUserScript") {
    targetTabId = sender.tab.id;
    const targetTabUrl = sender.tab.url;
    // 生成唯一的临时脚本ID，方便后续注销
    tempScriptUniqueId = `temp_user_script_${Date.now()}`;

    try {
      // 注册用户脚本
      await chrome.userScripts.register([{
        id: tempScriptUniqueId,
        matches: [targetTabUrl],
        world: "MAIN", // 和UserScripts默认的运行上下文保持一致
        js: [{
          code: `
            // 用户脚本运行时，先向后台验证当前tab是否为目标页
            chrome.runtime.sendMessage({ action: "verifyTabIdentity" }, (isTargetTab) => {
              if (isTargetTab) {
                // 这里写你的核心脚本逻辑
                alert("Hi!");
                // 执行完成后通知后台注销临时脚本
                chrome.runtime.sendMessage({ 
                  action: "unregisterTempScript", 
                  scriptId: "${tempScriptUniqueId}" 
                });
              }
            });
          `
        }]
      }]);
      sendResponse({ msg: "临时用户脚本已注册" });
    } catch (err) {
      sendResponse({ msg: "注册失败", error: err.message });
    }
    return true; // 保持消息通道开放，支持异步响应
  }

  // 处理tab身份验证请求
  if (message.action === "verifyTabIdentity") {
    const currentTab = await chrome.tabs.getCurrent();
    sendResponse(currentTab.id === targetTabId);
  }

  // 处理注销临时脚本的请求
  if (message.action === "unregisterTempScript") {
    await chrome.userScripts.unregister({ ids: [message.scriptId] });
    targetTabId = null;
    tempScriptUniqueId = null;
  }
});

注意事项 #

• 要在扩展的manifest.json中声明必要权限："userScripts", "tabs", "runtime"
• 如果你需要脚本持久运行（不是执行一次就注销），可以去掉注销逻辑，但要注意在标签页关闭时清理对应的脚本
• 由于UserScripts API目前还在Beta阶段，后续Chrome可能会推出直接支持tabID的功能，到时候可以简化这个流程

备注：内容来源于stack exchange，提问作者Kritidipto Ghosh