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
lastErrorundefinedsein. extension.inIncognitoContext-
Truefü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. Gibtnullzurü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.