runtime

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

Es stellt auch Messaging-APIs zur Verfügung, die es Ihnen ermöglichen:

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

Typen

runtime.Port: Repräsentiert ein Ende einer Verbindung zwischen zwei spezifischen Kontexten, die verwendet werden kann, um Nachrichten auszutauschen.
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 Veraltet: Der veraltete Enumerationswert, der die Google Native Client-Architektur repräsentiert. Erwägen Sie, zu PlatformArch zu migrieren, das von Safari und Mozilla unterstützt wird und die echte CPU-Architektur darstellt sowie korrekte Bitbreiteninformationen auf ARM vermittelt.
runtime.RequestUpdateCheckStatus: Ergebnis eines Aufrufs von runtime.requestUpdateCheck().
runtime.OnInstalledReason: Der Grund, warum das Ereignis runtime.onInstalled ausgelöst wird.
runtime.OnPerformanceWarningCategory: Die Warnkategorie, die das Ereignis runtime.onPerformanceWarning ausgelöst hat.
runtime.OnPerformanceWarningSeverity: Die Warnstufe, die das Ereignis runtime.onPerformanceWarning ausgelöst hat.
runtime.OnRestartRequiredReason: Der Grund, warum das Ereignis runtime.onRestartRequired ausgelöst wird.

Eigenschaften

runtime.lastError: Dieser Wert wird gesetzt, wenn eine asynchrone Funktion einen Fehlerzustand hat, den sie ihrem Aufrufer melden muss.
runtime.id: Die ID der Erweiterung.

Funktionen

runtime.getBackgroundPage(): Ruft das Window-Objekt der Hintergrundseite ab, die innerhalb der aktuellen Erweiterung läuft.
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-Elementes ab.
runtime.getManifest(): Ruft eine Objektrepräsentation der vollständigen manifest.json-Datei ab.
runtime.getURL(): Gibt einen vollqualifizierten URL zurück, wenn ein relativer Pfad von der manifest.json zu einer Ressource, die mit der Erweiterung gepackt ist, angegeben wird.
runtime.getVersion(): Ruft die Versionszeichenfolge der Erweiterung aus dem manifest.json-Datei-version-Schlüssel ab. Die zurückgegebene Version kann von der Zeichenfolge in der Datei abweichen, da der Browser sie analysieren und serialisieren kann.
runtime.setUninstallURL(): Setzt eine URL, die besucht wird, wenn die Erweiterung deinstalliert wird.
runtime.reload(): Lädt die Erweiterung neu.
runtime.requestUpdateCheck(): Prüft, ob Updates für diese Erweiterung vorhanden sind.
runtime.connect(): Stellt eine Verbindung von einem Inhalts-Skript zum Hauptprozess der Erweiterung oder von einer Erweiterung zu einer anderen her.
runtime.connectNative(): Verbindet die Erweiterung mit einer nativen Anwendung auf dem Computer des Benutzers.
runtime.sendMessage(): Sendet eine Nachricht zu Ereignis-Listenern innerhalb Ihrer Erweiterung oder einer anderen Erweiterung. Ähnlich wie runtime.connect, sendet aber nur eine einzelne Nachricht, mit einer optionalen 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 einen DirectoryEntry für das Paketverzeichnis zurück.

Ereignisse

runtime.onStartup: Wird ausgelöst, wenn ein Profil, das diese Erweiterung installiert hat, das erste Mal gestartet wird. Dieses Ereignis wird nicht ausgelöst, wenn ein Inkognito-Profil gestartet wird.
runtime.onInstalled: Wird ausgelöst, wenn die Erweiterung erstmals installiert wird, wenn die Erweiterung auf eine neue Version aktualisiert wird und wenn 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 doch nicht entladen wird.
runtime.onUpdateAvailable: Wird ausgelöst, wenn ein Update verfügbar ist, aber nicht sofort installiert wird, da die Erweiterung derzeit ausgeführt wird.
runtime.onBrowserUpdateAvailable Veraltet: Wird ausgelöst, wenn ein Update für den Browser verfügbar ist, aber nicht sofort installiert wird, da ein Neustart des Browsers erforderlich ist.
runtime.onConnect: Wird ausgelöst, wenn eine Verbindung entweder mit einem Erweiterungsprozess oder einem Inhaltsskript hergestellt wird.
runtime.onConnectExternal: Wird ausgelöst, wenn eine Verbindung zu einer anderen Erweiterung hergestellt wird.
runtime.onUserScriptConnect: Wird ausgelöst, wenn eine Verbindung mit einem von der Erweiterung registrierten Benutzerskript hergestellt wird.
runtime.onMessage: Wird ausgelöst, wenn eine Nachricht entweder von einem Erweiterungsprozess oder einem Inhaltsskript gesendet wird.
runtime.onMessageExternal: Wird ausgelöst, wenn eine Nachricht von einer anderen Erweiterung gesendet wird. Kann nicht in einem Inhaltsskript verwendet werden.
runtime.onUserScriptMessage: Wird ausgelöst, wenn eine Nachricht von einem registrierten Benutzerskript gesendet wird.
runtime.onPerformanceWarning: Wird ausgelöst, wenn ein Leistungsproblem zur Laufzeit für die Erweiterung erkannt wird.
runtime.onRestartRequired: Wird ausgelöst, wenn das Gerät neu gestartet werden muss.

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf der Chromium-API chrome.runtime. Diese Dokumentation stammt aus runtime.json im Chromium-Code.

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden