Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
extension
Dienstprogramme im Zusammenhang mit Ihrer Erweiterung. Erhalten Sie URLs zu Ressourcen, die mit Ihrer Erweiterung gebündelt sind. Erhalten Sie dasWindow-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 imruntime-Modul.
In diesem Artikel
Typen
extension.ViewTypeDer Typ der Erweiterungsansicht.
Eigenschaften
extension.lastErrorVeraltetFür die Lebensdauer eines Rückrufs festgelegt, wenn eine asynchrone Erweiterungs-API zu einem Fehler geführt hat. Wenn kein Fehler aufgetreten ist, ist
lastErrorundefined.extension.inIncognitoContextTruefü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. Gibtnullzurück, wenn die Erweiterung keine Hintergrundseite hat.extension.getExtensionTabs()VeraltetGibt ein Array der JavaScript-Window-Objekte für jeden der Tabs zurück, die innerhalb der aktuellen Erweiterung laufen.
extension.getURL()VeraltetWandelt 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()VeraltetSendet 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.onRequestVeraltetWird ausgelöst, wenn eine Anfrage von einem Erweiterungsprozess oder einem Inhaltsskript gesendet wird.
extension.onRequestExternalVeraltetWird ausgelöst, wenn eine Anfrage von einer anderen Erweiterung gesendet wird.
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:Diese API basiert auf derchrome.extension-API von Chromium. Diese Dokumentation wird ausextension.json im Chromium-Code abgeleitet.