如何在Firefox自定义按钮中调用完整HTML页面保存功能

1. 现代Firefox WebExtensions实现方式 #

要调用浏览器内置的「完整网页」保存功能，推荐使用WebExtensions API，具体步骤如下：

• 配置权限：在扩展的manifest.json中添加必要权限：

  {
    "manifest_version": 3,
    "name": "自定义保存按钮",
    "version": "1.0",
    "permissions": ["downloads", "activeTab"],
    "action": {}
  }
  

• 按钮点击逻辑：在扩展的背景脚本中添加点击事件，触发原生保存对话框：

  browser.action.onClicked.addListener(async (tab) => {
    // 唤起浏览器原生保存对话框，用户可选择「完整网页」类型
    await browser.downloads.download({
      url: tab.url,
      filename: `${tab.title}.html`,
      saveAs: true,
      conflictAction: "uniquify"
    });
  });
  

如果希望直接唤起默认指向「完整网页」的保存流程，可通过命令API触发原生菜单命令：

browser.action.onClicked.addListener(() => {
  browser.commands.executeCommand("save-page");
});

需在manifest.json中补充命令声明：

"commands": {
  "_execute_action": {
    "suggested_key": {
      "default": "Ctrl+Shift+S"
    }
  }
}

2. Legacy扩展方法（已废弃） #

旧版Firefox的legacy扩展可直接调用核心保存模块，但现代Firefox已禁用该方式，仅作参考：

Components.utils.import("resource://gre/modules/ContentAreaUtils.jsm");
ContentAreaUtils.saveDocument(gBrowser.selectedBrowser.contentDocument, null, null, true);

关键提示 #

你提到的contentAreaUtils.js中的saveDocument确实是原生保存功能的核心实现，但现代WebExtensions受沙箱限制无法直接访问该模块，必须通过官方暴露的downloads或commands API实现需求。

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