runtime

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

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

Kommunikation zwischen verschiedenen Teilen Ihrer Erweiterung. Für Ratschläge zur Auswahl zwischen den Messaging-Optionen siehe Auswahl zwischen Einmalnachrichten und verbindungsbasiertem Messaging.
Kommunikation mit anderen Erweiterungen.
Kommunikation mit nativen Anwendungen.

Typen

runtime.Port: Repräsentiert ein Ende einer Verbindung zwischen zwei spezifischen Kontexten, die zum Nachrichtenaustausch verwendet werden können.
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.PlatformNaclArch: Die Architektur des nativen Clients. Dies kann sich auf einigen Plattformen von PlatformArch unterscheiden.
runtime.RequestUpdateCheckStatus: Ergebnis eines Aufrufs von runtime.requestUpdateCheck().
runtime.OnInstalledReason: Der Grund dafür, dass 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 dafür, dass das runtime.onRestartRequired-Ereignis ausgelöst wird.

Eigenschaften

runtime.lastError: Dieser Wert wird gesetzt, wenn eine asynchrone Funktion eine Fehlermeldung hat, die sie an ihren Aufrufer melden muss.
runtime.id: Die ID der Erweiterung.

Funktionen

runtime.getBackgroundPage(): Holt das Window-Objekt für die Hintergrundseite, die innerhalb der aktuellen Erweiterung läuft.
runtime.openOptionsPage(): Öffnet die Optionsseite Ihrer Erweiterung.
runtime.getContexts(): Ruft Details über die Kontexte ab, die mit der Erweiterung verbunden sind.
runtime.getFrameId(): Ruft die Frame-ID eines beliebigen Fenster-Globalelementes oder Rahmenelementes ab.
runtime.getManifest(): Erhält die vollständige manifest.json-Datei, serialisiert als Objekt.
runtime.getURL(): Bei einem relativen Pfad von der manifest.json zu einer mit der Erweiterung gepackten Ressource wird eine vollständig qualifizierte URL zurückgegeben.
runtime.setUninstallURL(): Legt eine URL fest, die beim Deinstallieren der Erweiterung besucht 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 Inhalts-Skript zum Haupterweiterungsprozess 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 Nachricht an Ereignis-Listener innerhalb Ihrer Erweiterung oder einer anderen Erweiterung. Ähnlich wie runtime.connect sendet aber nur eine einzelne Nachricht, mit optionaler Antwort.
runtime.sendNativeMessage(): Sendet eine 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 startet. Dieses Ereignis wird nicht ausgelöst, wenn ein Inkognito-Profil gestartet wird.
runtime.onInstalled: Wird ausgelöst, wenn die Erweiterung erstmals installiert, die Erweiterung auf eine neue Version aktualisiert oder der Browser auf eine neue Version aktualisiert wird.
runtime.onSuspend: Wird an die Ereignisseite gesendet, kurz bevor die Erweiterung entladen wird. Dies gibt der Erweiterung die Möglichkeit, einige Bereinigungen durchzuführen.
runtime.onSuspendCanceled: Wird nach runtime.onSuspend gesendet, um anzuzeigen, dass die Erweiterung letztendlich nicht entladen wird.
runtime.onUpdateAvailable: Wird ausgelöst, wenn ein Update verfügbar ist, aber nicht sofort installiert wird, weil 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, da ein Browser-Neustart erforderlich ist.
runtime.onConnect: Wird ausgelöst, wenn eine Verbindung mit entweder einem Erweiterungsprozess oder einem Inhalts-Skript hergestellt wird.
runtime.onConnectExternal: Wird ausgelöst, wenn eine Verbindung mit einer anderen Erweiterung hergestellt wird.
runtime.onUserScriptConnect: Wird ausgelöst, wenn eine Verbindung mit einem Benutzerskript hergestellt wird, das von der Erweiterung registriert wurde.
runtime.onMessage: Wird ausgelöst, wenn eine Nachricht von entweder einem Erweiterungsprozess oder einem Inhalts-Skript gesendet wird.
runtime.onMessageExternal: Wird ausgelöst, wenn eine Nachricht von einer anderen Erweiterung gesendet wird. Kann nicht in einem Inhalts-Skript verwendet werden.
runtime.onUserScriptMessage: Wird ausgelöst, wenn eine Nachricht von einem Benutzerskript gesendet wird, das von der Erweiterung registriert wurde.
runtime.onPerformanceWarning: Wird ausgelöst, wenn ein Laufzeit-Performance-Problem für die Erweiterung erkannt wird.
runtime.onRestartRequired: Wird ausgelöst, wenn das Gerät neu gestartet werden muss.

Browser-Kompatibilität

Beispielerweiterungen

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