Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

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 toutes les deux cette valeur, alors le paramètre de la dernière extension installée aura la priorité.

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. Ceci doit être une URL HTTPS
suggest_url_post_params Facultatif
Chaîne de caractères : paramètres POST à envoyer àsuggest_url.

Compatibilité de navigateur

BCD tables only load in the browser