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 ein benutzerdefiniertes Ersatzdokument für die verschiedenen speziellen Seiten bereitzustellen, die normalerweise vom Browser selbst bereitgestellt werden.

Syntax

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

Name Typ Beschreibung

Name	Typ	Beschreibung
`bookmarks`	`String`	Ersetzen Sie die Seite, die die Lesezeichen anzeigt.
`history`	`String`	Ersetzen Sie die Seite, die den Browserverlauf anzeigt.
`newtab`	`String`	Ersetzen Sie das Dokument, 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 geladen wurde: zum Beispiel durch die Verwendung der Tastenkombination `Ctrl`/`Command`+`T`. 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, hat Zugriff auf die gleichen privilegierten "browser.*" APIs wie das Hintergrundskript der Erweiterung. Es ist sehr empfehlenswert, einen <title> für die Seite einzuschließen, andernfalls wird der Titel des Tabs die "moz-extension://..." URL sein. 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 zu der vom Benutzer definierten Seite navigiert. Wenn zwei oder mehr Erweiterungen benutzerdefinierte neue Tab-Seiten definieren, wird die zuletzt installierte oder aktivierte Erweiterung ihren Wert verwenden. Um die Startseite des Browsers zu überschreiben, verwenden Sie stattdessen "chrome_settings_overrides".

bookmarks

String

Ersetzen Sie die Seite, die die Lesezeichen anzeigt.

history

String

Ersetzen Sie die Seite, die den Browserverlauf anzeigt.

newtab

String

Ersetzen Sie das Dokument, 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 geladen wurde: zum Beispiel durch die Verwendung der Tastenkombination Ctrl/Command+T.

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, hat Zugriff auf die gleichen privilegierten "browser.*" APIs wie das Hintergrundskript der Erweiterung.

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

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 zu der vom Benutzer definierten Seite navigiert.

Wenn zwei oder mehr Erweiterungen benutzerdefinierte neue Tab-Seiten definieren, wird die zuletzt installierte oder aktivierte Erweiterung ihren Wert verwenden.

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

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

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