tabs.captureVisibleTab()
建立指定視窗中活動標籤頁區域的編碼資料 URL。您必須擁有 <all_urls> 或 activeTab 許可權。
注意：在 Firefox 125 及更早版本中，此方法僅在擁有 <all_urls> 許可權時可用。
除了擴充套件程式通常可以訪問的網站之外，此方法還允許擴充套件程式捕獲受限制的敏感網站，包括瀏覽器 UI 頁面和其他擴充套件程式的頁面。這些敏感網站只能使用 activeTab 許可權進行捕獲。如果擴充套件程式獲得了檔案訪問許可權，Chrome 也允許捕獲檔案 URL。
這是一個非同步函式，返回一個 Promise。
語法
js
let capturing = browser.tabs.captureVisibleTab(
windowId, // optional integer
options // optional extensionTypes.ImageDetails
)
引數
windowId可選-
integer。目標視窗。預設為當前視窗。 options可選
返回值
一個 Promise，它會以編碼捕獲影像的資料 URL 來完成。它可以被分配給 HTML 影像元素的 'src' 屬性進行顯示。如果發生任何錯誤，Promise 會以錯誤訊息拒絕。
示例
使用預設影像設定捕獲當前視窗中活動標籤頁的影像
js
function onCaptured(imageUri) {
console.log(imageUri);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener(() => {
let capturing = browser.tabs.captureVisibleTab();
capturing.then(onCaptured, onError);
});
瀏覽器相容性
載入中…
注意：此 API 基於 Chromium 的 chrome.tabs API。本文件源自 Chromium 程式碼中的 tabs.json。