extension

Dienstprogramme im Zusammenhang mit Ihrer Erweiterung. Erhalten Sie URLs zu Ressourcen, die mit Ihrer Erweiterung gebündelt sind. Erhalten Sie das Window-Objekt für die Seiten Ihrer Erweiterung. Erhalten Sie 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: Für die Lebensdauer eines Rückrufs festgelegt, wenn eine asynchrone Erweiterungs-API zu einem Fehler geführt hat. Wenn kein Fehler aufgetreten ist, ist lastError undefined.
extension.inIncognitoContext: True für Inhaltsskripte, die in privaten Tabs ausgeführt werden, und für Erweiterungsseiten, die in einem privaten Prozess laufen. (Letzteres gilt nur für Erweiterungen mit "incognito": "split" in ihrer manifest.json-Datei.)

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 der JavaScript-Window-Objekte für jeden der Tabs zurück, die innerhalb der aktuellen Erweiterung laufen.
extension.getURL() Veraltet: Wandelt einen relativen Pfad innerhalb eines Erweiterungs-Installationsverzeichnisses 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 laufen.
extension.isAllowedIncognitoAccess(): Ruft den Status des Zugriffs der Erweiterung auf den Inkognito-Modus ab (wie durch das nutzergesteuerte Kontrollkästchen 'Allowed in Incognito' bestimmt).
extension.isAllowedFileSchemeAccess(): Ruft den Status des Zugriffs der Erweiterung auf das file://-Schema ab (wie durch das nutzergesteuerte Kontrollkästchen 'Allow access to File URLs' bestimmt).
extension.sendRequest() Veraltet: Sendet eine einzige 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 werden, ignoriert.

Ereignisse

extension.onRequest Veraltet: Wird ausgelöst, wenn eine Anfrage von einem Erweiterungsprozess oder einem Inhaltsskript gesendet wird.
extension.onRequestExternal Veraltet: 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 wird aus extension.json im Chromium-Code abgeleitet.