chrome.pageCapture

refresh date: 2026-09-25 robots: noindex

说明

使用 chrome.pageCapture API 将标签页保存为 MHTML。

权限

pageCapture

MHTML 是大多数浏览器都支持的标准格式。它将一个网页及其所有资源（CSS 文件、图片等）封装在一个文件中。

请注意，出于安全原因，MHTML 文件只能从文件系统加载，并且只能在主框架中加载。

清单

必须在扩展程序清单中声明“pageCapture”权限，才能使用 pageCapture API。例如：

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

方法

saveAsMHTML()

Promise 
chrome.pageCapture.saveAsMHTML(
  details: object,
  callback?: function,
): Promise<Blob | undefined>

将具有给定 ID 的标签页的内容保存为 MHTML。

参数

  • 详细信息

    对象

    • tabId

      数值

      要另存为 MHTML 的标签页的 ID。

  • callback

    函数可选

    callback 参数如下所示： 

    (mhtmlData?: Blob) => void

    • mhtmlData

      Blob （可选）

      Blob 形式的 MHTML 数据。

返回

  • Promise<Blob | undefined>

    Chrome 116 及更高版本

    在生成 MHTML 时解析。

    只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。