Chrome扩展右键菜单项不显示问题排查求助

1. 核心错误：manifest.json 配置不符合Manifest V3规范 #

你当前的background字段沿用了Manifest V2的写法，Manifest V3中service worker的配置方式完全不同，错误的配置导致后台脚本根本没有被加载，菜单项自然无法注册。

2. 次要优化：菜单项注册时机调整 #

直接在脚本顶层调用chrome.contextMenus.create会存在重复注册的风险（service worker被回收后重启时会重复执行顶层代码，触发ID重复的报错），建议绑定到chrome.runtime.onInstalled事件中执行，该事件仅在扩展安装、更新时触发一次。

修正后的代码 #

manifest.json #

{
  "name": "name",
  "description": "description",
  "version": "1.0",
  "manifest_version": 3,
  "permissions": [
    "contextMenus"
  ],
  "background": {
    "service_worker": "eventPage.js"
  },
  "action": {
    "default_icon": "icon.png"
  },
  "icons": {
    "16": "icon.png"
  }
}

eventPage.js #

chrome.runtime.onInstalled.addListener(() => {
  const contextMenuItem = {
    "id": "id",
    "title": "title",
    "contexts": ["selection"]
  }
  chrome.contextMenus.create(contextMenuItem);
})

测试注意事项 #

你配置的菜单项触发上下文是selection，只有在页面中选中任意文本内容后右键，才会显示该菜单项，未选中文本时右键不会出现。

修改完成后到扩展管理页面（chrome://extensions/）点击对应扩展的刷新按钮，重新加载扩展后即可测试。

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