chrome_url_overrides

Typ Object
Obligatorisch Nein
Manifest-Version 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

Ersatz für die Seite bereitstellen, die die Lesezeichen anzeigt.

history String

Ersatz für die Seite bereitstellen, die den Browserverlauf anzeigt.

newtab String

Ersatz für das Dokument bereitstellen, das auf der "Neuer Tab" Seite angezeigt wird. Dies ist die Seite, die angezeigt wird, wenn der Benutzer einen neuen Tab geöffnet hat, aber noch kein Dokument darin geladen hat: z. B. durch Verwendung der Strg/Befehl+T Tastenkombination.

Der Ersatz wird als URL zu einer HTML-Datei angegeben. Die Datei muss mit der Erweiterung gebündelt sein: Sie können hier keine externe URL angeben. Sie können es relativ zum Stammverzeichnis 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 ausgeführt wird, erhält Zugriff auf die gleichen privilegierten "browser.*" APIs wie das Hintergrundskript der Erweiterung.

Es ist eine sehr gute Praxis, einen <title> für die Seite hinzuzufügen, andernfalls wird der Titel des Tabs die "moz-extension://..." URL sein.

Ein häufiger Anwendungsfall ist es, dem Benutzer zu erlauben, eine neue Tab-Seite zu definieren: um dies zu tun, stellen Sie eine benutzerdefinierte neue Tab-Seite bereit, die zu der vom Benutzer definierten Seite navigiert.

Wenn zwei oder mehr Erweiterungen jeweils benutzerdefinierte neue Tab-Seiten definieren, dann wird die zuletzt installierte oder aktivierte den Vorzug erhalten.

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

Alle Eigenschaften sind lokalisierbar.

Beispiel

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

Browser-Kompatibilität

BCD tables only load in the browser