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
tabIdOptional-
integer. ID des Tabs, der erfasst werden soll. Standardmäßig der aktive Tab im aktuellen Fenster. optionsOptional
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
Loading…
Hinweis: Diese API basiert auf der Chromium-API chrome.tabs. Diese Dokumentation stammt aus tabs.json im Chromium-Code.