Chrome-Seiten überschreiben

Erweiterungen können Seiten, die Google Chrome normalerweise bereitstellt, durch HTML-Überschreibungsseiten ersetzen. Eine Erweiterung kann eine Überschreibung für jede der folgenden Seiten enthalten, aber jede Erweiterung kann nur eine Seite überschreiben:

Lesezeichenmanager
Die Seite, die angezeigt wird, wenn der Nutzer im Chrome-Menü den Menüpunkt „Lesezeichenmanager“ oder auf einem Mac im Menü „Lesezeichen“ den Menüpunkt „Lesezeichenmanager“ auswählt. Sie können diese Seite auch über die URL chrome://bookmarks aufrufen.
Verlauf
Die Seite, die angezeigt wird, wenn der Nutzer im Chrome-Menü den Menüpunkt „Verlauf“ auswählt. Auf Mac-Computern wählt der Nutzer im Menü „Verlauf“ den Eintrag „Gesamten Verlauf anzeigen“ aus. Sie können diese Seite auch aufrufen, indem Sie die URL chrome://history eingeben.
Neuer Tab
Die Seite, die angezeigt wird, wenn der Nutzer einen neuen Tab oder ein neues Fenster erstellt. Sie können diese Seite auch durch Eingabe der URL chrome://newtab aufrufen.

Die folgenden Screenshots zeigen die standardmäßige „Neuer Tab“-Seite und anschließend eine benutzerdefinierte „Neuer Tab“-Seite.

Die standardmäßige "Neuer Tab"-Seite
Standardmäßige Seite „Neuer Tab“.
Benutzerdefinierte „Neuer Tab“-Seite
Eine benutzerdefinierte „Neuer Tab“-Seite.

Um dies zu testen, sehen Sie sich unsere Überschreibungsbeispiele an.

Verhalten von Inkognitofenstern

In Inkognitofenstern können Erweiterungen die „Neuer Tab“-Seiten nicht überschreiben. Andere Seiten funktionieren weiterhin, wenn die Manifest-Property Incognito auf "spanning" (Standardwert) gesetzt ist. Weitere Informationen zum Umgang mit Inkognitofenstern finden Sie unter Daten und Inkognitomodus speichern.

Manifest

Registrieren Sie mit dem folgenden Code eine Überschreibungsseite im Erweiterungsmanifest:

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

Ersetzen Sie PAGE_TO_OVERRIDE durch einen der folgenden Werte:

  • "bookmarks"
  • "history"
  • "newtab"

Best Practices

  • Mache deine Seite schnell und klein.
    Nutzer erwarten, dass integrierte Browserseiten sofort geöffnet werden. Vermeiden Sie Dinge, die viel Zeit in Anspruch nehmen könnten. Vermeiden Sie insbesondere den synchronen Zugriff auf Datenbankressourcen. Bei Netzwerkanfragen sollten Sie fetch() gegenüber XMLHttpRequest() vorziehen.

  • Gib deiner Seite einen Titel, um Verwirrung bei den Nutzern zu vermeiden.
    Ohne Titel wird standardmäßig die URL als Seitentitel verwendet. Gib den Titel mithilfe des <title>-Tags in der HTML-Datei an.

  • Bei neuen Tabs wird der Tastaturfokus zuerst auf die Adressleiste ausgerichtet.
    Verlassen Sie sich nicht darauf, dass der Tastaturfokus standardmäßig auf andere Teile der Seite gesetzt wird.

  • Die „Neuer Tab“-Seite personalisieren
    Erstellen Sie keine „Neuer Tab“-Seite, die Nutzer mit der standardmäßigen „Neuer Tab“-Seite in Chrome verwechseln könnte.

Beispiele

Weitere Informationen finden Sie unter Überschreibungsbeispiele.