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);
  });
});

瀏覽器相容性