tabs.saveAsPDF()

将当前页面另存为 PDF 文件。这将打开一个由底层操作系统提供的对话框,询问用户要将 PDF 文件保存在何处。

这是一个异步函数,返回一个 Promise

语法

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

参数

pageSettings

object。有关已保存页面的设置,为一个 tabs.PageSettings 对象。此对象是必需的,但其所有属性都是可选的。未在此处指定的任何属性都将获取 PageSettings 文档中列出的默认值。

返回值

一个 Promise,当对话框关闭时,它将以一个状态字符串 fulfilled。该字符串可以是以下任意一项:

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

示例

在此示例中,一个后台脚本监听对 浏览器操作 的点击,然后尝试将当前活动标签页另存为 PDF 文件,然后记录结果。

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

浏览器兼容性