tabs.captureVisibleTab()

Erstellt eine Daten-URL, die das Bild eines Bereichs des aktiven Tabs im angegebenen Fenster codiert. Sie müssen entweder die <all_urls>- oder die activeTab-Berechtigung haben.

Hinweis: In Firefox 125 und früher war diese Methode nur mit der <all_urls>-Berechtigung verfügbar.

Zusätzlich zu den Seiten, auf die Erweiterungen normalerweise zugreifen können, ermöglicht diese Methode den Erweiterungen, sensible Seiten zu erfassen, die ansonsten eingeschränkt sind, einschließlich Browser-UI-Seiten und Seiten anderer Erweiterungen. Diese sensiblen Seiten können nur mit der activeTab-Berechtigung erfasst werden. Chrome erlaubt es auch, Datei-URLs zu erfassen, wenn die Erweiterung Dateizugriff gewährt wurde.

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

Syntax

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

Parameter

windowId Optional

integer. Das Ziel-Fenster. Standardmäßig das aktuelle Fenster.

options Optional

extensionTypes.ImageDetails.

Rückgabewert

Ein Promise, das mit einer Daten-URL erfüllt wird, die das erfasste Bild codiert. Es kann der 'src'-Eigenschaft eines HTML-Image-Elements zur Anzeige zugewiesen werden. Wenn ein Fehler auftritt, wird das Versprechen mit einer Fehlermeldung abgelehnt.

Beispiele

Erfassen Sie ein Bild des aktiven Tabs im aktuellen Fenster mit den standardmäßigen Bildeinstellungen:

js
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

BCD tables only load in the browser

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