如何开发Firefox扩展拦截快捷键，避免ctrl-w误关标签页？

可行性说明 #

开发Firefox扩展拦截并转发快捷键完全可行。通过内容脚本注入目标网页，可在浏览器处理快捷键前捕获事件，阻止默认行为并将事件传递给Web应用。

代码失效原因及修正 #

你的代码没有触发键盘事件监听，核心问题有两点：

1. 脚本运行环境错误 #

如果代码写在扩展的后台脚本（background script）中，根本无法监听网页的键盘事件——后台脚本运行在扩展的独立沙箱环境，与网页上下文完全隔离。必须将键盘监听代码作为**内容脚本（content script）**注入到目标网页中。

2. 事件监听时机与参数错误 #

Firefox对内置快捷键（如Ctrl+W）会在事件捕获阶段优先处理，默认的冒泡阶段监听器无法捕获到事件。需要：

• 将监听器的第三个参数设为true（开启捕获模式），在浏览器处理前拦截事件
• 调用preventDefault()和stopImmediatePropagation()阻止浏览器的默认行为

修正后的内容脚本示例 #

// 内容脚本中编写以下代码
document.addEventListener('keydown', function(e) {
    // 匹配Ctrl+W组合键
    if (e.getModifierState('Control') && e.key === 'w') {
        console.log('拦截到Ctrl+W');
        // 阻止Firefox关闭标签页的默认行为
        e.preventDefault();
        e.stopImmediatePropagation();
        // 事件会自然传递给Web应用的快捷键监听器
    }
}, true); // 第三个参数true开启捕获模式

扩展Manifest配置（Manifest V3） #

确保在manifest.json中正确配置内容脚本的注入范围，比如只针对目标Web应用：

{
  "manifest_version": 3,
  "name": "快捷键拦截工具",
  "version": "1.0",
  "content_scripts": [
    {
      "matches": ["https://目标Web应用域名/*"],
      "js": ["content.js"],
      "run_at": "document_start" // 确保脚本在页面加载前注入，优先拦截事件
    }
  ]
}

额外注意事项 #

• 测试时，需查看网页的控制台而非扩展后台控制台——内容脚本的日志会输出到网页控制台。
• 如果目标Web应用的快捷键监听器也是捕获模式，run_at: "document_start"配置能保证你的脚本优先拦截事件。

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