Manifest V3 Chrome扩展chrome.action.onClicked未定义报错原因求助

问题原因分析 #

报错Uncaught TypeError: Cannot read properties of undefined (reading 'onClicked')的本质是chrome.action对象未被正确初始化，你的业务代码本身没有语法问题，可按以下方向排查：

// 你当前的业务逻辑代码符合Manifest V3规范
chrome.action.onClicked.addListener(tab => {
    chrome.windows.create({
        url: chrome.runtime.getURL("popup.html"),
        type: "popup",
        height: 800,
        width: 516
      }, function(win) {
      });
});

排查步骤 #

• 检查manifest.json配置
  1. 确认manifest_version字段值为3，Manifest V2版本不存在chrome.actionAPI，对应接口为chrome.browserAction
  2. 必须显式声明action字段，即使没有自定义配置也要保留"action": {}，缺失该字段会直接导致chrome.action未定义
  3. 不要在action配置中添加default_popup字段，配置默认弹出页后onClicked事件会被自动屏蔽，但不会触发本次的对象未定义错误
• 检查代码存放位置
  chrome.action是扩展特权API，仅能在扩展的可信上下文中运行，如果你近期调整了代码存放位置会触发该错误：
  1. 仅后台服务工作线程（manifest中service_worker字段指定的JS文件）、扩展自有页面（如options.html、popup.html引入的JS）可以访问该API
  2. 内容脚本中无法访问chrome.action接口，代码误放到内容脚本会直接报错
• 检查浏览器运行环境
  1. 确认当前Chrome版本≥88，低版本Chrome对Manifest V3的API支持不完整
  2. 到chrome://extensions/扩展管理页重载扩展，排除扩展加载异常的问题

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