tabs.captureTab()

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

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 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 kodiert. Diese URL kann der 'src'-Eigenschaft eines HTML-Bild-Elements zugewiesen werden, um es anzuzeigen. Bei einem Fehler wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Erfassen eines Bildes des aktiven Tabs im aktuellen Fenster mit den Standardeinstellungen:

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

Hinweis: Diese API basiert auf der Chromium-API chrome.tabs. Diese Dokumentation stammt aus tabs.json im Chromium-Code.