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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
captureVisibleTab

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

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