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
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
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:
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.