tabs.captureTab()
创建一个数据 URL,编码给定标签页区域图像。你必须拥有 <all_urls>
权限才能使用此方法。
这是一个返回 Promise
的异步函数。
js
let capturing = browser.tabs.captureTab(
tabId, // 可选的整数
options // 可选的 extensionTypes.ImageDetails
)
参数
tabId
可选-
integer
。要捕获的标签页的 ID。默认为当前窗口中的活动标签页。 options
可选
返回值
一个 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
。