Firefox 94版本下AddOn如何实现指定浏览器窗口前置聚焦？

问题解答 #

2021年Firefox 94版本环境下存在可落地的窗口前置实现方案，无需用户手动修改about:config配置，符合面向普通用户的扩展产品要求。

具体实现指引 #

1. 配置manifest.json权限 #

首先需要在扩展的manifest.json中申请两个必要权限，确保可以调用窗口、标签页相关的控制API：

{
  "manifest_version": 2,
  "name": "窗口快速切换工具",
  "version": "1.0",
  "permissions": ["tabs", "windows"],
  "background": {
    "scripts": ["background.js"]
  }
}

2. 正确调用窗口控制API #

你之前调用browser.windows.update失效的核心原因是参数传值错误：该API的第一个入参要求传入目标窗口ID（windowId），而非标签页ID（tabId）。
推荐将所有窗口操作逻辑放在background脚本中执行，可避免你遇到的can't access dead object报错（该报错是因为弹窗脚本上下文会在弹窗关闭后销毁，正在执行的异步调用会丢失上下文），参考代码如下：

// background.js 中实现的窗口前置逻辑
async function focusTargetWindow(tabId) {
  try {
    // 先通过标签页ID获取所属窗口ID
    const targetTab = await browser.tabs.get(tabId);
    const targetWindowId = targetTab.windowId;
    // 先恢复最小化的窗口，再设置聚焦前置
    await browser.windows.update(targetWindowId, {
      state: "normal",
      focused: true
    });
  } catch (e) {
    console.error("窗口聚焦执行失败：", e);
  }
}

// 接收弹窗/快捷键的操作指令
browser.runtime.onMessage.addListener((message) => {
  if (message.type === 'focus_window' && message.tabId) {
    focusTargetWindow(message.tabId);
  }
});

3. Ubuntu桌面环境适配说明 #

Ubuntu等Linux发行版的桌面环境默认仅允许用户主动触发的操作修改窗口层级，你需要确保触发窗口聚焦的操作是来自用户交互（比如点击扩展按钮、按下扩展注册的全局快捷键），非用户主动触发的后台自动聚焦操作会被系统拦截，属于正常的安全限制。

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