chrome_settings_overrides

Utilisez la clé chrome_settings_overrides pour remplacer certains paramètres du navigateur. Deux paramètres sont disponibles :

  • "homepage", qui vous permet de remplacer la page d'accueil du navigateur.
  • "search_provider", qui vous permet d'ajouter un nouveau moteur de recherche.
"chrome_settings_overrides" : {
  "homepage": "https://developer.mozilla.org/"
}
"chrome_settings_overrides": {
  "search_provider": {
    "name": "Discogs",
    "search_url": "https://www.discogs.com/search/?q={searchTerms}",
    "keyword": "disc",
    "favicon_url": "https://www.discogs.com/favicon.ico"
  }
}
clé de manifeste : chrome_settings_overrides
Type Objet
Obligatoire Non

Syntaxe

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

Nom Type Description
homepage Chaîne de caractères

Définit la page à utiliser comme page d'accueil du navigateur.

Le remplacement est donné comme une URL. L'URL peut :

  • pointer sur un fichier regroupé avec l'extension, auquel cas il est donné comme une URL relative au fichier manifest.json
  • être une URL distante comme "https://developer.mozilla.org/".

Si deux ou plusieurs extensions définissent cette valeur, le dernier qui se lance (c'est-à-dire le plus récemment installé ou activé) gagne. Si l'utilisateur modifie la page d'accueil à l'aide des préférences utilisateur du navigateur, cela évite le choix de l'extension.

Pour éviter de nouveaux onglets, utilisez à la place "chrome_url_overrides".

C'est une  propriété localisable.

search_provider Objet

Définit un moteur de recherche à ajouter au navigateur.

Le moteur de recherche a un nom et une URL principale. D'autres URL peuvent être fournies, y compris des URL pour des recherches plus spécialisées comme des recherches d'images. Dans l'URL que vous fournissez, utilisez "{searchTerms}" pour interpoler le terme de recherche  dans l'URL, comme : https://www.discogs.com/search/?q={searchTerms}. Vous pouvez également fournir des paramètres POST à envoyer avec la recherche.

Le moteur de recherche sera présenté à l'utilisateur à côté de ceux fournis dans l'interface. Si vous incluez la propriété is_defaultet le configurez avec true, le nouveau moteur de recherche devient l'option par défaut. Avec l'utilisation de la propriétékeyword, vous permettez à l'utilisateur de sélectionner votre moteur de recherche en tapant le mot-clé dans la barre d'adresse avant le terme recherché.

C'est un objet avec les propriétés listées ci-dessous. Toutes les propriétés chaîne de caractères sont localisables.

name
Chaîne de caractères : le nom du moteur de recherche, affiché pour l'utilisateur.
search_url
Chaîne de caractères : l'URL utilisée par le moteur de recherche. Il peut être une URL HTTPS.
is_default
Booléen: "True" si le moteur de recherch doit être le choix par défaut.
alternate_urls Facultatif
Tableau de chaînes de caractères : un éventail d'URL alternatives, qui peut être utilisé à la place desearch_url.
encoding Facultatif
Chaîne de caractères : codage du terme de recherche, spécifié comme un standard character encoding name, voir "UTF-8".
favicon_url Facultatif
Chaîne de caractères : URL pointant sur une icône pour le moteur de recherche. Ce doit être une URL absolue HTTP ou HTTPS.
image_url Facultatif
Chaîne de caractères : URL utilisée pour une recherche d'images.
image_url_post_params Facultatif
Chaîne de caractères : paramètres POST à envoyer àimage_url.
instant_url Facultatif
Chaîne de caractères : URL utilisée pour une recherche instantanée.
instant_url_post_params Facultatif
Chaîne de caractères : paramètres POST à envoyer à instant_url.
keyword Facultatif
Chaîne de caractères : mots-clés de la barre d'adresse pour le moteur de recherche.
prepopulated_id Facultatif
L'ID d'un moteur de recherche intégré à utiliser.
search_url_post_params Facultatif
Chaîne de caractères : paramètres POST à envoyer àsearch_url.
suggest_url Facultatif
Chaîne de caractères : URL utilisée pour les suggestions de recherche.
suggest_url_post_params Facultatif
Chaîne de caractères : paramètres POST à envoyer àsuggest_url.

Compatibilité de navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
homepageChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_providerChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_provider.alternate_urlsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.encodingChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.favicon_urlChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_provider.image_urlChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.image_url_post_paramsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.instant_urlChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.instant_url_post_paramsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.is_defaultChrome Support complet OuiEdge Aucun support NonFirefox Support complet 57
Notes
Support complet 57
Notes
Notes The user is asked to opt into the default search change unless it is a built-in engine.
Opera Aucun support NonFirefox Android Aucun support Non
search_provider.keywordChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_provider.nameChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_provider.prepopulated_idChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.search_urlChrome Support complet OuiEdge Aucun support NonFirefox Support complet 55Opera Aucun support NonFirefox Android Aucun support Non
search_provider.search_url_post_paramsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.suggest_urlChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
search_provider.suggest_url_post_paramsChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non
startup_pagesChrome Support complet OuiEdge Aucun support NonFirefox Aucun support NonOpera Aucun support NonFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : loella16, Ostefanini, hellosct1
Dernière mise à jour par : loella16,