tabs.captureTab()

创建指定标签页区域的图像数据 URL。您必须拥有 <all_urls> 权限才能使用此方法。

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

语法

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

参数

tabId 可选

integer。要捕获的标签页 ID。默认为当前窗口中的活动标签页。

options 可选

extensionTypes.ImageDetails.

返回值

一个 Promise,它将以编码捕获图像的数据 URL 来解析。可以将其分配给 HTML Image 元素的 'src' 属性以进行显示。如果发生任何错误,Promise 将以错误消息被拒绝。

示例

捕获当前窗口中活动标签页的图像,使用默认设置

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

浏览器兼容性

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