tabs.captureTab()

创建给定选项卡区域图像的 data URL 编码。您必须具有 <all_urls> 权限才能使用此方法。

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

语法

let capturing = browser.tabs.captureTab(
  tabId,               // optional integer
  options              // optional extensionTypes.ImageDetails
)

参数

tabId 可选: integer。要捕获的选项卡的 ID。默认为当前窗口的活动选项卡。
options 可选: extensionTypes.ImageDetails.

返回值

一个 Promise，它将使用编码捕获图像的 data URL 来完成。可以将其分配给 HTML Image 元素的 'src' 属性以进行显示。如果出现任何错误，promise 将使用错误消息被拒绝。

示例

使用默认设置捕获当前窗口中活动选项卡的图像

function onCaptured(imageUri) {
  console.log(imageUri);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener(() => {
  let capturing = browser.tabs.captureTab();
  capturing.then(onCaptured, onError);
});

浏览器兼容性

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

注意： 此 API 基于 Chromium 的 chrome.tabs API。此文档源自 Chromium 代码中的 tabs.json。