chrome_url_overrides

Typ Object
Verpflichtend Nein
Manifestversion 2 oder höher
Beispiel
json
  "chrome_url_overrides" : {
    "newtab": "my-new-tab.html"
  }

Verwenden Sie den Schlüssel chrome_url_overrides, um einen benutzerdefinierten Ersatz für die Dokumente bereitzustellen, die in verschiedenen speziellen Seiten geladen werden, die normalerweise vom Browser selbst bereitgestellt werden.

Syntax

Der Schlüssel chrome_url_overrides ist ein Objekt, das die folgenden Eigenschaften haben kann:

Name Typ Beschreibung
bookmarks String

Stellen Sie einen Ersatz für die Seite bereit, die die Lesezeichen anzeigt.

history String

Stellen Sie einen Ersatz für die Seite bereit, die den Browserverlauf anzeigt.

newtab String

Stellen Sie einen Ersatz für das Dokument bereit, das auf der "neue Tab"-Seite angezeigt wird. Dies ist die Seite, die gezeigt wird, wenn der Benutzer einen neuen Tab geöffnet hat, aber kein Dokument darin geladen hat: zum Beispiel durch die Verwendung des Strg/Command+T-Tastenkürzels.

Der Ersatz wird als URL zu einer HTML-Datei angegeben. Die Datei muss mit der Erweiterung gebündelt sein: Sie können hier keine Remote-URL angeben. Sie können sie relativ zum Stammordner der Erweiterung angeben, wie: "path/to/newtab.html".

Das Dokument kann CSS und JavaScript laden, genau wie eine normale Webseite. JavaScript, das auf der Seite läuft, erhält Zugriff auf dieselben privilegierten "browser.*"-APIs wie das Hintergrundskript der Erweiterung.

Es ist eine sehr gute Praxis, einen <title> für die Seite einzuschließen, da der Titel des Tabs sonst die "moz-extension://..."-URL sein wird.

Ein häufiger Anwendungsfall ist es, dem Benutzer zu ermöglichen, eine neue Tab-Seite zu definieren: Um dies zu tun, stellen Sie eine benutzerdefinierte neue Tab-Seite bereit, die zur vom Benutzer definierten Seite navigiert.

Wenn zwei oder mehr Erweiterungen benutzerdefinierte neue Tab-Seiten definieren, dann wird der Wert der zuletzt installierten oder aktivierten Erweiterung verwendet.

Um die Startseite des Browsers zu überschreiben, verwenden Sie stattdessen "chrome_settings_overrides".

Alle Eigenschaften sind lokalisierbar.

Beispiel

json
"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}

Browser-Kompatibilität