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 URL relativ zur Datei manifest.json angegeben
  • eine externe URL sein, wie "https://developer.mozilla.org/".

Wenn zwei oder mehr Erweiterungen diesen Wert festlegen, 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. Alternative URLs können bereitgestellt werden, einschließlich URLs für speziellere Suchen wie die Bildersuche. In der von Ihnen gelieferten 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 angezeigt. Wenn Sie die Eigenschaft is_default einschließen und auf true setzen, wird der neue Suchanbieter die Standardoption. Durch Angabe der Eigenschaft keyword ermöglichen Sie dem Benutzer, Ihren Suchanbieter auszuwählen, indem er das Schlüsselwort in die Such-/Adressleiste eingibt, bevor der Suchbegriff eingegeben wird.

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: True, wenn die Suchmaschine die Standardauswahl sein soll. In Firefox ist dies optional und der Benutzer wird nur beim ersten Mal gefragt, wenn die Erweiterung installiert wird. Bei später hinzugefügter Suchmaschine wird nicht erneut gefragt.
alternate_urls Optional
Array von Strings: Ein Array von alternativen URLs, die anstelle der search_url verwendet werden können.
encoding Optional
String: Kodierung des Suchbegriffs, angegeben als standardisierte Zeichensatzkodierung, wie "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 innerhalb der Erweiterung verweisen, angegeben als ein Pfad relativ zum Wurzelverzeichnis der Erweiterung.
image_url Optional
String: URL, die für die Bildersuche 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: Schlüsselwort in der Adressleiste 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.
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.
suggest_url_post_params Optional
String: POST-Parameter, die an suggest_url gesendet werden.

Beispiel

Dieses Beispiel zeigt, wie man einen Suchanbieter festlegt.

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