chrome_settings_overrides

Typ Object
Verpflichtend Nein
Manifest-Version 2 oder höher
Beispiel
json
"chrome_settings_overrides" : {
  "homepage": "https://developer.mozilla.org/"
 },

Verwenden Sie den Schlüssel chrome_settings_overrides, um die Startseite des Browsers zu überschreiben und eine neue Suchmaschine hinzuzufügen.

Syntax

Der Schlüssel chrome_settings_overrides ist ein Objekt, das die folgenden Eigenschaften haben kann:

Name Typ Beschreibung
homepage String

Definiert die Seite, die als Startseite des Browsers verwendet werden soll.

Der Ersatz wird als URL angegeben. Die URL kann:

  • auf eine mit der Erweiterung gebündelte Datei verweisen, in diesem Fall wird sie als relative URL zur Datei manifest.json angegeben
  • eine entfernte URL sein, wie "https://developer.mozilla.org/".

Wenn zwei oder mehr Erweiterungen diesen Wert setzen, dann hat die Einstellung der zuletzt installierten Erweiterung Vorrang.

Um neue Tabs zu überschreiben, verwenden Sie stattdessen "chrome_url_overrides".

Dies ist eine lokalisierbare Eigenschaft.

search_provider Object

Definiert einen Suchanbieter, der dem Browser hinzugefügt werden soll.

Der Suchanbieter hat einen Namen und eine primäre Such-URL. Alternative URLs können angegeben werden, einschließlich URLs für spezialisiertere Suchen wie die Bildsuche. In der angegebenen URL verwenden Sie {searchTerms}, um den Suchbegriff in die URL einzufügen, wie: https://www.discogs.com/search/?q={searchTerms}. Sie können auch POST-Parameter bereitstellen, die zusammen mit der Suche gesendet werden.

Der Suchanbieter wird dem Benutzer neben den integrierten Anbietern präsentiert. Wenn Sie die Eigenschaft is_default einschließen und auf true setzen, wird der neue Suchanbieter die Standardoption sein. Wenn Sie die Eigenschaft keyword bereitstellen, können Benutzer Ihren Suchanbieter auswählen, indem sie das Schlüsselwort vor dem Suchbegriff in die Such-/Adressleiste eingeben.

Dies ist ein Objekt mit den unten aufgeführten Eigenschaften. Alle String-Eigenschaften sind lokalisierbar.

name
String: Der Name der Suchmaschine, der dem Benutzer angezeigt wird.
search_url
String: URL, die von der Suchmaschine verwendet wird. Dies muss eine HTTPS-URL sein.
is_default Optional
Boolean: Wahr, wenn die Suchmaschine die Standardwahl sein soll. In Firefox ist dies nur durch Benutzerbestätigung erlaubt und der Benutzer wird nur beim ersten Mal gefragt, wenn die Erweiterung installiert wird. Er wird nicht nochmals gefragt, wenn später eine Suchmaschine hinzugefügt wird.
alternate_urls Optional
Array von Strings: Ein Array von alternativen URLs, die anstelle von search_url verwendet werden können.
encoding Optional
String: Codierung des Suchbegriffs, angegeben als ein standardisierter Zeichensatzname, wie "UTF-8".
favicon_url Optional
String: URL, die auf ein Icon für die Suchmaschine verweist. In Manifest V2 muss dies eine absolute HTTP- oder HTTPS-URL sein. In Manifest V3 muss dies auf ein in der Erweiterung bereitgestelltes Icon als Pfad relativ zum Stamm der Erweiterung verweisen.
image_url Optional
String: URL, die für die Bildsuche verwendet wird.
image_url_post_params Optional
String: POST-Parameter, die an image_url gesendet werden.
instant_url Optional
String: URL, die für die Sofortsuche verwendet wird.
instant_url_post_params Optional
String: POST-Parameter, die an instant_url gesendet werden.
keyword Optional
String: Adressleisten-Schlüsselwort für die Suchmaschine.
prepopulated_id Optional
Die ID einer integrierten Suchmaschine, die verwendet werden soll.
search_url_get_params Optional
String: GET-Parameter, die an search_url gesendet werden. Nur in Firefox verfügbar, für optimale Cross-Browser-Kompatibilität verwenden Sie stattdessen search_url.
search_url_post_params Optional
String: POST-Parameter, die an search_url gesendet werden.
suggest_url Optional
String: URL, die für Suchvorschläge verwendet wird. Dies muss eine HTTPS-URL sein.
suggest_url_get_params Optional
String: GET-Parameter, die an suggest_url gesendet werden. Nur in Firefox verfügbar, für optimale Cross-Browser-Kompatibilität verwenden Sie stattdessen suggest_url.
suggest_url_post_params Optional
String: POST-Parameter, die an suggest_url gesendet werden.

Beispiel

Dieses Beispiel zeigt, wie ein Suchanbieter festgelegt wird.

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"
  }
}

Browser-Kompatibilität