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