Remplacer les pages Chrome

Les extensions peuvent utiliser des pages de forçage HTML pour remplacer une page que Google Chrome fournit normalement. Une extension peut contenir un forçage pour l'une des pages suivantes, mais chaque extension ne peut remplacer qu'une seule page:

Gestionnaire de favoris

Page qui s'affiche lorsque l'utilisateur sélectionne l'élément de menu "Gestionnaire de favoris" dans le menu Chrome ou, sur Mac, l'élément "Gestionnaire de favoris" dans le menu "Favoris". Vous pouvez également accéder à cette page en saisissant l'URL chrome://bookmarks.

Historique

Page qui s'affiche lorsque l'utilisateur sélectionne l'élément de menu "Historique" dans le menu Chrome ou, sur Mac, l'élément "Afficher l'historique complet" dans le menu "Historique". Vous pouvez également accéder à cette page en saisissant l'URL chrome://history.

Nouvel onglet

Page qui s'affiche lorsque l'utilisateur crée un nouvel onglet ou une nouvelle fenêtre. Vous pouvez également accéder à cette page en saisissant l'URL chrome://newtab.

Les captures d'écran suivantes montrent la page "Nouvel onglet" par défaut, puis une page "Nouvel onglet" personnalisée.

Pour essayer, consultez nos exemples de forçage.

Comportement de la fenêtre de navigation privée

Dans les fenêtres de navigation privée, les extensions ne peuvent pas remplacer les pages "Nouvel onglet". Les autres pages fonctionnent toujours si la propriété de fichier manifeste navigation privée est définie sur "spanning" (valeur par défaut). Pour savoir comment gérer les fenêtres de navigation privée, consultez Enregistrer des données et mode navigation privée.

Fichier manifeste

Utilisez le code suivant pour enregistrer une page de forçage dans le fichier manifeste de l'extension:

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

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

Remplacez PAGE_TO_OVERRIDE par l'un des éléments suivants:

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

Bonnes pratiques

• Rendez votre page rapide et petite.
  Les utilisateurs s'attendent à ce que les pages du navigateur intégré s'ouvrent instantanément. Évitez de faire des choses qui peuvent prendre beaucoup de temps. Plus précisément, évitez d'accéder aux ressources de base de données de manière synchrone. Lorsque vous envoyez des requêtes réseau, privilégiez fetch() à XMLHttpRequest().

• Pour éviter toute confusion chez les utilisateurs, donnez un titre à votre page.
  Sans titre, l'URL est utilisée par défaut comme titre de la page. Spécifiez le titre à l'aide de la balise <title> dans votre fichier HTML.

• N'oubliez pas que les nouveaux onglets donnent la priorité à la barre d'adresse sur le clavier.
  Ne comptez pas sur le fait que le focus du clavier se déplace par défaut vers d'autres parties de la page.

• Personnalisez la page "Nouvel onglet".
  Évitez de créer une page "Nouvel onglet" que les utilisateurs pourraient confondre avec la page "Nouvel onglet" par défaut de Chrome.

Exemples

Consultez les exemples de remplacement.