chrome_url_overrides

Type	`Objet`
Obligatoire	Non
Exemple	json `"chrome_url_overrides" : { "newtab": "my-new-tab.html" }`

Utilisez la clé chrome_url_overrides pour fournir un remplacement personnalisé pour les documents chargés dans différentes pages spéciales généralement fournies par le navigateur lui-même.

Syntaxe

La clé chrome_url_overrides est un objet qui peut avoir les propriétés suivantes:

Nom Type Description

Nom	Type	Description
`bookmarks`	Chaîne de caractères	Remplace la page qui affiche les signets.
`history`	chaîne de caractères	Remplace la page qui affiche l'historique de navigation.
`newtab`	chaîne de caractères	Remplace le document qui s'affiche dans la page "Nouvel onglet". Ceci est la page affichée lorsque l'utilisateur a ouvert un nouvel onglet, mais n'a chargé aucun document : par exemple, en utilisant le raccourci clavier `Ctrl`/`Command`+`T`. Le remplacement est donné en tant qu'URL d'un fichier HTML. Le fichier doit être regroupé avec l'extension : vous ne pouvez pas spécifier une URL distante ici. Vous pouvez le spécifier par rapport au dossier racine de l'extension, comme : "path/to/newtab.html". Le document peut charger CSS et JavaScript, tout comme une page Web normale. L'utilisation de JavaScript dans la page permet d'accéder aux mêmes API privilégiées "browser.*" comme une extension d'arrière-plan. Il est très pratique d'inclure un <title> pour la page, ou le titre de l'onglet sera l'URL "moz-extension://..." . Un cas d'utilisation courant est de permettre à l'utilisateur de définir une nouvelle page d'onglet : pour ce faire, fournir une nouvelle page d'onglet personnalisée qui navigue vers la page définie par l'utilisateur. Si deux ou plusieurs extensions définissent toutes les deux de nouvelles pages à onglet personnalisées, alors la dernière à être installée ou activée utilise sa valeur. Pour remplacer la page d'accueil du navigateur, utilisez plutôt "chrome_settings_overrides".

bookmarks

Chaîne de caractères

Remplace la page qui affiche les signets.

history

chaîne de caractères

Remplace la page qui affiche l'historique de navigation.

newtab

chaîne de caractères

Remplace le document qui s'affiche dans la page "Nouvel onglet". Ceci est la page affichée lorsque l'utilisateur a ouvert un nouvel onglet, mais n'a chargé aucun document : par exemple, en utilisant le raccourci clavier Ctrl/Command+T.

Le remplacement est donné en tant qu'URL d'un fichier HTML. Le fichier doit être regroupé avec l'extension : vous ne pouvez pas spécifier une URL distante ici. Vous pouvez le spécifier par rapport au dossier racine de l'extension, comme : "path/to/newtab.html".

Le document peut charger CSS et JavaScript, tout comme une page Web normale. L'utilisation de JavaScript dans la page permet d'accéder aux mêmes API privilégiées "browser.*" comme une extension d'arrière-plan.

Il est très pratique d'inclure un <title> pour la page, ou le titre de l'onglet sera l'URL "moz-extension://..." .

Un cas d'utilisation courant est de permettre à l'utilisateur de définir une nouvelle page d'onglet : pour ce faire, fournir une nouvelle page d'onglet personnalisée qui navigue vers la page définie par l'utilisateur.

Si deux ou plusieurs extensions définissent toutes les deux de nouvelles pages à onglet personnalisées, alors la dernière à être installée ou activée utilise sa valeur.

Pour remplacer la page d'accueil du navigateur, utilisez plutôt "chrome_settings_overrides".

Toutes les propriétés sont localisables.

Exemple

json

"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}

Compatibilité des navigateurs

BCD tables only load in the browser