Chrome扩展tabs.onActivated在新标签页、扩展管理页不生效如何修复

该问题90%以上是manifest.json权限配置缺失导致，Chrome对受限制页面（新标签页、内置系统页面、扩展管理页）的标签事件做了权限隔离，未配置对应权限时不会触发扩展的事件回调。

修复步骤 #

• 第一步：补充manifest权限配置 #

  如果你用的是目前主流的Manifest V3版本，添加以下配置：

  {
    "manifest_version": 3,
    "name": "你的扩展名称",
    "version": "1.0",
    "background": {
      "service_worker": "background.js"
    },
    "permissions": ["tabs"],
    "host_permissions": ["<all_urls>"]
  }
  

  如果你仍在使用Manifest V2版本，配置如下：

  {
    "manifest_version": 2,
    "name": "你的扩展名称",
    "version": "1.0",
    "background": {
      "scripts": ["background.js"]
    },
    "permissions": ["tabs", "<all_urls>"]
  }
  

• 第二步：优化事件监听逻辑 #

  原onUpdated事件会在页面加载的不同阶段多次触发，建议添加加载完成判断，避免重复执行checkingProcess：

  chrome.tabs.onActivated.addListener((activeInfo) => {
    checkingProcess(activeInfo.tabId)
  })
  
  chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => {
    if (changeInfo.status === 'complete') {
      checkingProcess(tabId)
    }
  })
  

• 第三步：校验后台监听注册逻辑 #

  如果是Manifest V3版本，后台是Service Worker，所有事件监听必须写在入口文件的顶层同步执行，不能放在异步函数、回调函数内部注册，否则Service Worker休眠唤醒后会丢失事件监听，导致事件不触发。

注意事项 #

• 扩展管理页（chrome://extensions/）属于Chrome的安全敏感页面，浏览器默认禁止所有扩展监听该页面的标签事件，属于正常安全限制，无绕过方案
• 权限修改后必须到扩展管理页重新加载扩展才能生效，仅刷新页面不会更新权限配置
• 如果需要监听本地文件页面的事件，需要手动在扩展管理页打开对应扩展的「允许访问文件网址」开关

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