chrome.pageCapture

說明

使用 chrome.pageCapture API 將分頁儲存為 MHTML。

MHTML 是大部分瀏覽器支援的標準格式。它會以單一檔案封裝頁面及其所有資源 (CSS 檔案、圖片)。

請注意,基於安全考量,MHTML 檔案只能從檔案系統載入,而且只能在主頁框中載入。

權限

pageCapture

您必須在擴充功能資訊清單中宣告「pageCapture」權限,才能使用 pageCapture API。例如:

{
  "name": "My extension",
  ...
  "permissions": [
    "pageCapture"
  ],
  ...
}

方法

saveAsMHTML()

Promise
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
)

將指定 ID 的分頁內容儲存為 MHTML。

參數

  • 詳細資料

    物件

    • tabId

      號碼

      要儲存為 MHTML 的分頁 ID。

  • 回呼

    函式選用

    callback 參數如下所示:

    (mhtmlData?: ArrayBuffer)=>void

    • mhtmlData

      ArrayBuffer 選用

      做為 Blob 的 MHTML 資料。

傳回

  • Promise<ArrayBuffer|undefined>

    Chrome 116 以上版本

    Manifest V3 以上版本支援 Promise,但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。