tabs.captureTab()

创建一个数据 URL,编码给定标签页区域图像。你必须拥有 <all_urls> 权限才能使用此方法。

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

js
let capturing = browser.tabs.captureTab(
  tabId,               // 可选的整数
  options              // 可选的 extensionTypes.ImageDetails
)

参数

tabId 可选

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

options 可选

extensionTypes.ImageDetails

返回值

一个 Promise,其会兑现一个编码了捕获图像的数据 URL。可以赋值给 HTML 图片元素的 'src' 属性来显示。如果发生任何错误,promise 将被拒绝并带有错误消息。

示例

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

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

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

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

浏览器兼容性

BCD tables only load in the browser

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