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);
});
浏览器兼容性
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
captureTab |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
备注:
此 API 基于 Chromium 的 chrome.tabs
API。本文档内容源自 Chromium 代码中的 tabs.json
。