首次Firefox扩展测试遇阻：contextMenus未定义及菜单不显示问题

初始代码问题分析 #

• 核心错误：content script（main.js）运行在网页上下文，无权访问browser.contextMenus API——这个API仅能在扩展的后台脚本、弹出页等扩展专属上下文使用。初始代码中调用browser.contextMenus.create会抛出TypeError: browser.contextMenus is undefined，中断后续代码执行，导致alert('Test 2')无法运行。

调整后代码的问题 #

将逻辑移到background.js后，仍存在两个关键问题：

1. 未定义onCreated回调函数：调用browser.contextMenus.create时传入了onCreated参数，但代码中未声明该函数，会导致菜单创建失败。
2. 事件页面执行时机问题：虽然Firefox允许在persistent: false的事件页面直接调用contextMenus.create，但直接写在全局作用域的代码可能因事件页面休眠未被执行，更可靠的方式是绑定到扩展启动/安装事件。

修复方案 #

1. 修正background.js代码 #

补全onCreated函数，并将菜单创建逻辑绑定到runtime.onInstalled事件，确保扩展安装或更新时初始化菜单：

function onCreated() {
  if (browser.runtime.lastError) {
    console.log(`创建菜单失败: ${browser.runtime.lastError}`);
  } else {
    console.log("菜单创建成功");
  }
}

function onError(error) {
  console.log(`错误: ${error}`);
}

// 扩展安装/更新时初始化上下文菜单
browser.runtime.onInstalled.addListener(() => {
  browser.contextMenus.create(
    {
      id: "AlertTest",
      title: "Test2",
      contexts: ["all"],
    },
    onCreated,
  );
});

browser.contextMenus.onClicked.addListener((info, tab) => {
  switch (info.menuItemId) {
    case "AlertTest":
      console.log(info.selectionText);
      // 如需在网页中弹出alert，需通过消息通知content script
      browser.tabs.sendMessage(tab.id, {action: "showAlert"}).catch(onError);
      break;
  }
});

2. 可选：添加content script实现网页alert（若需） #

如果要在点击菜单时在网页中弹出alert，需在manifest.json中重新添加content script配置：

{
  "manifest_version": 2,
  "version": "1.0",
  "name": "Test",
  "background": {
      "scripts": ["background.js"],
      "persistent": false
  },
  "content_scripts":[
    {
     "matches":["<all_urls>"],
     "js":["main.js"]
    }
  ],
  "permissions": [
    "contextMenus",
    "activeTab"
  ]
}

然后在main.js中监听后台消息：

browser.runtime.onMessage.addListener((message) => {
  if (message.action === "showAlert") {
    alert("The test extension is up and running");
  }
});

3. 调试技巧 #

• 查看后台日志：在Firefox扩展管理页面，点击扩展的「检查视图」→「检查后台页面」，打开控制台查看错误信息。
• 验证权限：确认manifest.json中contextMenus权限拼写正确，无遗漏。

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