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 wird.

Der Ersatz wird als URL angegeben. Die URL kann:

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

Wenn zwei oder mehr Erweiterungen diesen Wert setzen, hat die Einstellung der zuletzt installierten 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. Es können alternative URLs bereitgestellt werden, einschließlich URLs für spezialisiertere Suchen wie die Bildersuche. In der von Ihnen angegebenen URL verwenden Sie "{searchTerms}", um den Suchbegriff in die URL zu interpolieren, wie: https://www.discogs.com/search/?q={searchTerms}. Sie können auch POST-Parameter angeben, die mit der Suche gesendet werden sollen.

Der Suchanbieter wird dem Benutzer neben den integrierten Anbietern angezeigt. Wenn Sie die Eigenschaft is_default einfügen und auf true setzen, wird der neue Suchanbieter die Standardoption sein. Durch Angabe der keyword-Eigenschaft ermöglichen Sie dem Benutzer, Ihren Suchanbieter auszuwählen, indem er das Schlüsselwort vor dem Suchbegriff in die Such-/Adressleiste eingibt.

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: Von der Suchmaschine verwendete URL. Dies muss eine HTTPS-URL sein.
is_default Optional
Boolean: True, wenn die Suchmaschine die Standardwahl sein soll. In Firefox ist dies eine Opt-In Funktion und der Benutzer wird nur beim ersten Mal gefragt, wenn die Erweiterung installiert wird. Sie werden nicht erneut gefragt, wenn später eine Suchmaschine hinzugefügt wird.
alternate_urls Optional
Array von Strings: Ein Array alternativer URLs, die anstelle der search_url verwendet werden können.
encoding Optional
String: Kodierung des Suchbegriffs, angegeben als ein Standard-Zeichencodierungsname, wie zum Beispiel "UTF-8".
favicon_url Optional
String: URL, die auf ein Symbol für die Suchmaschine verweist. In Manifest V2, muss dies eine absolute HTTP- oder HTTPS-URL sein. In Manifest V3 muss dies auf ein Symbol verweisen, das in der Erweiterung als Pfad relativ zum Stammverzeichnis der Erweiterung bereitgestellt wird.
image_url Optional
String: Für die Bildsuche verwendete URL.
image_url_post_params Optional
String: POST-Parameter, die an image_url gesendet werden.
instant_url Optional
String: Für die Sofortsuche verwendete URL.
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_post_params Optional
String: POST-Parameter, die an search_url gesendet werden.
suggest_url Optional
String: Für Suchvorschläge verwendete URL. Dies muss eine HTTPS-URL sein.
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

BCD tables only load in the browser