Chrome Extension MV3未开启无痕权限时Service Worker注册失败求助

问题原因 #

当你的扩展在manifest中配置"incognito": "split"，但用户未授权扩展在无痕窗口运行时，无痕窗口会启动一个独立的Service Worker实例。这个实例尝试注册tabs/windows相关事件监听时，会因为权限限制被浏览器拦截，直接导致Service Worker注册失败——这就是你删除监听后错误消失的原因。

解决方案 #

核心思路是让无痕上下文的Service Worker实例跳过这些事件监听，只在普通窗口的Service Worker中注册。可以通过chrome.extension.inIncognitoContext判断当前上下文是否为无痕模式，代码示例如下：

// 仅在非无痕环境下注册tabs/windows事件监听
if (!chrome.extension.inIncognitoContext) {
  chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => {
    // 你的业务逻辑
  });
  chrome.tabs.onActivated.addListener((activeInfo) => {
    // 你的业务逻辑
  });
  chrome.windows.onRemoved.addListener((windowId) => {
    // 你的业务逻辑
  });
  chrome.windows.onFocusChanged.addListener((windowId) => {
    // 你的业务逻辑
  });
  chrome.tabs.onRemoved.addListener((tabId, removeInfo) => {
    // 你的业务逻辑
  });
}

补充说明 #

"incognito": "split"模式下，普通窗口和无痕窗口会运行独立的Service Worker实例。上述判断会让无痕窗口的Service Worker跳过事件注册，避免触发权限错误；而普通窗口的Service Worker不受影响，正常保留所有功能。

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