Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

extension

Dienstprogramme im Zusammenhang mit Ihrer Erweiterung. Erhalten Sie URLs zu Ressourcenpaketen mit Ihrer Erweiterung. Erhalten Sie das Window-Objekt für die Seiten Ihrer Erweiterung. Erhalten Sie die Werte für verschiedene Einstellungen.

Hinweis: Die Messaging-APIs in diesem Modul sind veraltet zugunsten der entsprechenden APIs im runtime-Modul.

Typen

extension.ViewType

Der Typ der Erweiterungsansicht.

Eigenschaften

extension.lastError

Setzt sich für die Lebensdauer eines Rückrufs, wenn eine asynchrone Erweiterungs-API zu einem Fehler geführt hat. Wenn kein Fehler aufgetreten ist, wird lastError undefined sein.

extension.inIncognitoContext

True für Inhaltsskripte, die in Inkognito-Tabs ausgeführt werden, und für Erweiterungsseiten, die in einem Inkognito-Prozess ausgeführt werden. (Letzteres gilt nur für Erweiterungen, bei denen in der manifest.json-Datei "incognito": "split" gesetzt ist.)

Funktionen

extension.getBackgroundPage()

Gibt das Window-Objekt für die Hintergrundseite zurück, die innerhalb der aktuellen Erweiterung läuft. Gibt null zurück, wenn die Erweiterung keine Hintergrundseite hat.

extension.getExtensionTabs()

Gibt ein Array der JavaScript-Window-Objekte für jede der Tabs zurück, die innerhalb der aktuellen Erweiterung ausgeführt werden.

extension.getURL()

Wandelt einen relativen Pfad innerhalb eines Erweiterungsinstallationsverzeichnisses in eine vollqualifizierte URL um.

extension.getViews()

Gibt ein Array der Window-Objekte für jede der Seiten zurück, die innerhalb der aktuellen Erweiterung ausgeführt werden.

extension.isAllowedIncognitoAccess()

Ruft den Zustand des Zugriffs der Erweiterung auf Tabs ab, die im Modus "Privates Surfen" geöffnet wurden (wie durch die vom Benutzer kontrollierte 'Run in Private Windows' Option in den Berechtigungen der Erweiterung bestimmt).

extension.isAllowedFileSchemeAccess()

Ruft den Zustand des Zugriffs der Erweiterung auf das file://-Schema ab (wie durch eine benutzerkontrollierte Option in den Berechtigungen der Erweiterung bestimmt: 'Allow access to File URLs' in Chrome und 'Access local files on your computer' in Firefox).

extension.sendRequest()

Sendet eine einzelne Anfrage an andere Listener innerhalb der Erweiterung.

extension.setUpdateUrlData()

Setzt den Wert des ap-CGI-Parameters, der in der Update-URL der Erweiterung verwendet wird. Dieser Wert wird für Erweiterungen ignoriert, die im Store des Browserherstellers gehostet werden.

Ereignisse

extension.onRequest

Wird ausgelöst, wenn eine Anfrage von einem Erweiterungsprozess oder einem Inhaltsskript gesendet wird.

extension.onRequestExternal

Wird ausgelöst, wenn eine Anfrage von einer anderen Erweiterung gesendet wird.

Beispielerweiterungen

Browser-Kompatibilität

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