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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
chrome_url_overrides
bookmarks
history
newtab

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.
Uses a non-standard name.
Has more compatibility info.