Chrome扩展Manifest V3迁移时chrome.action为undefined如何解决

解决方案 #

第一步：修正manifest.json配置 #

你目前的permissions中保留了Manifest V2的废弃权限browser_action，这是导致chrome.action未定义的核心原因：

• Manifest V3中chrome.actionAPI不需要额外申请权限，只要manifest中声明了action配置项即可正常调用
• 残留旧版本的browser_action权限会导致Chrome API注册冲突，无法正常加载chrome.action
• 另外你打开选项页的逻辑不需要tabs权限，可以同步删除减少不必要的权限申请

修改后的permissions配置如下：

"permissions": [
  "activeTab"
]

第二步：优化后台Service Worker代码 #

推荐使用Chrome官方提供的runtime.openOptionsPage方法打开选项页，不需要手动写文件路径，避免路径匹配错误，代码更稳定：

const API = chrome || browser;

API.action.onClicked.addListener((tab) => {
    console.log("clicked icon on tab ", tab);
    API.runtime.openOptionsPage();
})

第三步：重新加载扩展 #

修改完成后，务必在Chrome扩展管理页面（chrome://extensions/）先移除现有扩展，再重新加载已解压的扩展包，避免旧缓存的配置残留导致问题复现。

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