tabs.captureVisibleTab()
Erstellt eine Daten-URL, die das Bild eines Bereichs des aktiven Tabs im angegebenen Fenster kodiert. Sie benötigen die Berechtigung <all_urls> oder die activeTab-Berechtigung.
Hinweis:
In Firefox 125 und früheren Versionen war diese Methode nur mit der Berechtigung <all_urls> verfügbar.
Neben Websites, auf die Erweiterungen normalerweise zugreifen können, können Erweiterungen mit dieser Methode auch Inhalte von ansonsten gesperrten sensiblen Websites erfassen. Dazu gehören Seiten der Browseroberfläche und Seiten anderer Erweiterungen. Diese sensiblen Websites können nur mit der activeTab-Berechtigung erfasst werden. Chrome erlaubt außerdem die Erfassung von Datei-URLs, wenn der Erweiterung der Zugriff auf Dateien gewährt wurde.
Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.
Syntax
let capturing = browser.tabs.captureVisibleTab(
windowId, // optional integer
options // optional extensionTypes.ImageDetails
)
Parameter
windowIdOptional-
integer. Das Zielfenster. Standardmäßig wird das aktuelle Fenster verwendet. optionsOptional
Rückgabewert
Ein Promise, das mit einer Daten-URL erfüllt wird, die das erfasste Bild kodiert. Diese URL kann zur Anzeige der 'src'-Eigenschaft eines HTML-Bildelements zugewiesen werden. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.
Beispiele
Erfassen Sie ein Bild des aktiven Tabs im aktuellen Fenster mit den Standardeinstellungen für Bilder:
function onCaptured(imageUri) {
console.log(imageUri);
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener(() => {
let capturing = browser.tabs.captureVisibleTab();
capturing.then(onCaptured, onError);
});
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.tabs-API. Diese Dokumentation wurde aus tabs.json im Chromium-Code abgeleitet.