tabs.saveAsPDF()

将当前页面另存为 PDF 文件。这将打开一个由底层操作系统提供的对话框，要求用户选择要保存 PDF 文件的位置。

这是一个异步函数，它返回一个 Promise。

语法

js
let saving = browser.tabs.saveAsPDF(
  pageSettings   // object
)

参数

pageSettings

object。保存页面的设置，作为 tabs.PageSettings 对象。必须提供此对象，但其所有属性都是可选的。此处未指定的任何属性都将获得 PageSettings 文档中列出的默认值。

返回值

一个 Promise，它将在对话框关闭时使用状态字符串完成。字符串可能是以下任何一个

  • "saved"
  • "replaced"
  • "canceled"
  • "not_saved"
  • "not_replaced"

示例

在此示例中，后台脚本侦听 浏览器操作 的点击事件，然后尝试将当前活动选项卡另存为 PDF 文件，最后记录结果

js
browser.browserAction.onClicked.addListener(() => {
  browser.tabs.saveAsPDF({}).then((status) => {
    console.log(status);
  });
});

浏览器兼容性

BCD 表仅在启用了 JavaScript 的浏览器中加载。