extension

Dienstprogramme im Zusammenhang mit Ihrer Erweiterung. Erhalten Sie URLs zu den Ressourcen, die mit Ihrer Erweiterung gebündelt sind. Erhalten Sie das Window-Objekt für die Seiten Ihrer Erweiterung. Holen Sie sich 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 Veraltet: Wird für die Lebensdauer eines Rückrufs gesetzt, wenn eine asynchrone Erweiterungs-API zu einem Fehler geführt hat. Wenn kein Fehler aufgetreten ist, ist lastError undefined.
extension.inIncognitoContext: True für Inhalts-Skripte, 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 im manifest.json-File "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() Veraltet: Gibt ein Array von JavaScript-Window-Objekten für jeden der Tabs zurück, die innerhalb der aktuellen Erweiterung laufen.
extension.getURL() Veraltet: Konvertiert einen relativen Pfad innerhalb eines Erweiterungsinstallationsverzeichnisses in eine vollständig qualifizierte URL.
extension.getViews(): Gibt ein Array der Window-Objekte für jede der Seiten zurück, die innerhalb der aktuellen Erweiterung laufen.
extension.isAllowedIncognitoAccess(): Ruft den Zustand des Zugriffs der Erweiterung auf den Inkognito-Modus ab (wie durch das vom Benutzer kontrollierte Kontrollkästchen 'In Inkognito erlaubt' bestimmt).
extension.isAllowedFileSchemeAccess(): Ruft den Zustand des Zugriffs der Erweiterung auf das file://-Schema ab (wie durch das vom Benutzer kontrollierte Kontrollkästchen 'Zugriff auf Datei-URLs erlauben' bestimmt).
extension.sendRequest() Veraltet: 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, die im Store des Browseranbieters gehostet sind, ignoriert.

Ereignisse

extension.onRequest Veraltet: Wird ausgelöst, wenn eine Anfrage entweder von einem Erweiterungsprozess oder einem Inhalts-Skript gesendet wird.
extension.onRequestExternal Veraltet: Wird ausgelöst, wenn eine Anfrage von einer anderen Erweiterung gesendet wird.

Browser-Kompatibilität

Beispielerweiterungen

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