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.

json

"chrome_settings_overrides" : {
  "homepage": "https://developer.mozilla.org/"
}

json

"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

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_default`et 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 recherche 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 de`search_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`.

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 recherche 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é des navigateurs

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨22 janv. 2024⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content