Chrome-Seiten überschreiben

Erweiterungen können HTML-Überschreibungsseiten verwenden, um eine Seite zu ersetzen, die normalerweise von Google Chrome bereitgestellt wird. Eine Erweiterung kann eine Überschreibung für eine beliebige 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“ auswählt oder auf einem Mac den Menüpunkt „Lesezeichenmanager“ im Menü „Lesezeichen“. 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 oder auf einem Mac im Menü „Verlauf“ die Option „Vollständigen Verlauf anzeigen“ auswählt. Sie können diese Seite auch über die URL chrome://history aufrufen.
Neuer Tab
Die Seite, die angezeigt wird, wenn der Nutzer einen neuen Tab oder ein neues Fenster erstellt. Sie können diese Seite auch über die URL chrome://newtab aufrufen.

Die folgenden Screenshots zeigen die Standardseite „Neuer Tab“ und dann eine benutzerdefinierte Seite „Neuer Tab“.

Die Standardseite „Neuer Tab“
Die Standardseite „Neuer Tab“
Eine benutzerdefinierte Seite „Neuer Tab“
Eine benutzerdefinierte Seite „Neuer Tab“

Weitere Informationen finden Sie in unseren Beispielen für Überschreibungen.

Verhalten von Inkognitofenstern

In Inkognitofenstern können Erweiterungen keine Neutab-Seiten überschreiben. Andere Seiten funktionieren weiterhin, wenn die Manifest-Eigenschaft incognito auf „spanning“ (Standardwert) festgelegt ist. Weitere Informationen zum Umgang mit Inkognitofenstern finden Sie unter Daten speichern und Inkognitomodus.

Manifest

Verwenden Sie den folgenden Code, um eine Überschreibungsseite im Manifest der Erweiterung zu registrieren:

{
  "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

  • Achten Sie darauf, dass Ihre Seite schnell und klein ist.
    Nutzer erwarten, dass integrierte Browserseiten sofort geöffnet werden. Vermeiden Sie Dinge, die viel Zeit in Anspruch nehmen. Vermeiden Sie insbesondere den synchronen Zugriff auf Datenbankressourcen. Verwenden Sie bei Netzwerkanfragen fetch() anstelle von XMLHttpRequest().

  • Geben Sie Ihrer Seite einen Titel, um Verwirrung bei den Nutzern zu vermeiden.
     Ohne Titel wird standardmäßig die URL als Seitentitel verwendet. Geben Sie den Titel mit dem Tag <title> in Ihrer HTML-Datei an.

  • Denken Sie daran, dass bei neuen Tabs der Tastaturfokus zuerst auf die Adressleiste gelegt wird.
    Vertrauen Sie nicht darauf, dass der Tastaturfokus standardmäßig auf andere Teile der Seite gesetzt wird.

  • Gestalten Sie die „Neuer Tab“-Seite nach Ihren Wünschen.
    Erstellen Sie keine Seite „Neuer Tab“, die Nutzer mit der Standardseite „Neuer Tab“ von Chrome verwechseln könnten.

Beispiele

Beispiele für Überschreibungen