runtime

Dieses Modul stellt Informationen über Ihre Erweiterung und die Umgebung, in der sie ausgeführt wird, bereit.

Es bietet auch Messaging-APIs, die es Ihnen ermöglichen:

Typen

runtime.Port

Repräsentiert ein Ende einer Verbindung zwischen zwei spezifischen Kontexten, die zum Austausch von Nachrichten verwendet werden kann.

runtime.MessageSender

Enthält Informationen über den Absender einer Nachricht oder Verbindungsanfrage.

runtime.PlatformOs

Identifiziert das Betriebssystem des Browsers.

runtime.PlatformArch

Identifiziert die Prozessorarchitektur des Browsers.

runtime.PlatformInfo

Enthält Informationen über die Plattform, auf der der Browser läuft.

runtime.RequestUpdateCheckStatus

Ergebnis eines Aufrufs von runtime.requestUpdateCheck().

runtime.OnInstalledReason

Der Grund, warum das runtime.onInstalled-Ereignis ausgelöst wird.

runtime.OnPerformanceWarningCategory

Die Kategorie der Warnung, die das runtime.onPerformanceWarning-Ereignis ausgelöst hat.

runtime.OnPerformanceWarningSeverity

Die Schwere der Warnung, die das runtime.onPerformanceWarning-Ereignis ausgelöst hat.

runtime.OnRestartRequiredReason

Der Grund, warum das runtime.onRestartRequired-Ereignis ausgelöst wird.

Eigenschaften

runtime.lastError

Dieser Wert wird gesetzt, wenn eine asynchrone Funktion eine Fehlerbedingung melden muss.

runtime.id

Die ID der Erweiterung.

Funktionen

runtime.getBackgroundPage()

Ruft das Window-Objekt für die Hintergrundseite ab, die innerhalb der aktuellen Erweiterung ausgeführt wird.

runtime.openOptionsPage()

Öffnet die Optionsseite Ihrer Erweiterung.

runtime.getContexts()

Ruft Details über die mit der Erweiterung verbundenen Kontexte ab.

runtime.getFrameId()

Ruft die Frame-ID eines beliebigen Fenster-Global- oder Frame-Elements ab.

runtime.getManifest()

Ruft die komplette manifest.json-Datei ab, serialisiert als Objekt.

runtime.getURL()

Gibt einen vollständig qualifizierten URL zurück, gemessen an einem relativen Pfad aus der manifest.json zu einer Ressource, die mit der Erweiterung verpackt ist.

runtime.setUninstallURL()

Setzt eine URL, die besucht wird, wenn die Erweiterung deinstalliert wird.

runtime.reload()

Lädt die Erweiterung neu.

runtime.requestUpdateCheck()

Prüft auf Updates für diese Erweiterung.

runtime.connect()

Stellt eine Verbindung von einem Content-Skript zum Hauptprozess der Erweiterung her oder von einer Erweiterung zu einer anderen Erweiterung.

runtime.connectNative()

Verbindet die Erweiterung mit einer nativen Anwendung auf dem Computer des Benutzers.

runtime.sendMessage()

Sendet eine einzelne Nachricht an Ereignis-Listener innerhalb Ihrer Erweiterung oder einer anderen Erweiterung. Ähnlich wie runtime.connect, sendet jedoch nur eine einzelne Nachricht mit einer optionalen Antwort.

runtime.sendNativeMessage()

Sendet eine einzelne Nachricht von einer Erweiterung an eine native Anwendung.

runtime.getPlatformInfo()

Gibt Informationen über die aktuelle Plattform zurück.

runtime.getBrowserInfo()

Gibt Informationen über den Browser zurück, in dem diese Erweiterung installiert ist.

runtime.getPackageDirectoryEntry()

Gibt ein DirectoryEntry für das Paketverzeichnis zurück.

Ereignisse

runtime.onStartup

Wird ausgelöst, wenn ein Profil, das diese Erweiterung installiert hat, zum ersten Mal gestartet wird. Dieses Ereignis wird nicht ausgelöst, wenn ein Inkognito-Profil gestartet wird.

runtime.onInstalled

Wird ausgelöst, wenn die Erweiterung zum ersten Mal installiert wird, wenn die Erweiterung zu einer neuen Version aktualisiert wird und wenn der Browser zu einer neuen Version aktualisiert wird.

runtime.onSuspend

Wird an die Ereignisseite gesendet, kurz bevor die Erweiterung entladen wird. Dies gibt der Erweiterung Gelegenheit, einige Aufräumarbeiten durchzuführen.

runtime.onSuspendCanceled

Wird nach runtime.onSuspend gesendet, um anzuzeigen, dass die Erweiterung doch nicht entladen wird.

runtime.onUpdateAvailable

Wird ausgelöst, wenn ein Update verfügbar ist, aber nicht sofort installiert wird, da die Erweiterung derzeit läuft.

runtime.onBrowserUpdateAvailable Veraltet

Wird ausgelöst, wenn ein Update für den Browser verfügbar ist, aber nicht sofort installiert wird, weil ein Neustart des Browsers erforderlich ist.

runtime.onConnect

Wird ausgelöst, wenn eine Verbindung mit einem Erweiterungsprozess oder einem Content-Skript hergestellt wird.

runtime.onConnectExternal

Wird ausgelöst, wenn eine Verbindung mit einer anderen Erweiterung hergestellt wird.

runtime.onMessage

Wird ausgelöst, wenn eine Nachricht von einem Erweiterungsprozess oder einem Content-Skript gesendet wird.

runtime.onMessageExternal

Wird ausgelöst, wenn eine Nachricht von einer anderen Erweiterung gesendet wird. Kann in einem Content-Skript nicht verwendet werden.

runtime.onPerformanceWarning

Wird ausgelöst, wenn ein Laufzeit-Performanceproblem für die Erweiterung erkannt wird.

runtime.onRestartRequired

Wird ausgelöst, wenn das Gerät neu gestartet werden muss.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiel-Erweiterungen