tabs.captureTab()

Erstellt eine Daten-URL, die das Bild eines Bereichs des angegebenen Tabs codiert. Sie müssen die <all_urls> Berechtigung haben, um diese Methode zu verwenden.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let capturing = browser.tabs.captureTab(
  tabId,               // optional integer
  options              // optional extensionTypes.ImageDetails
)

Parameter

tabId Optional

integer. ID des Tabs, der erfasst werden soll. Standardmäßig ist der aktive Tab im aktuellen Fenster.

options Optional

extensionTypes.ImageDetails.

Rückgabewert

Ein Promise, das mit einer Daten-URL erfüllt wird, welche das erfasste Bild codiert. Diese kann der 'src'-Eigenschaft eines HTML-Image-Elements zur Anzeige zugewiesen werden. Tritt ein Fehler auf, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Ein Bild des aktiven Tabs im aktuellen Fenster mit den Standardeinstellungen erfassen:

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);
});

Browser-Kompatibilität

BCD tables only load in the browser

Hinweis: Diese API basiert auf der chrome.tabs API von Chromium. Diese Dokumentation ist abgeleitet von tabs.json im Chromium-Code.