chrome_settings_overrides

Typ Object
Verpflichtend Nein
Manifest-Version 2 oder höher
Beispiel
"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 zeigen, in diesem Fall wird sie als URL relativ zur Datei manifest.json angegeben
  • eine entfernte URL sein, wie beispielsweise "https://developer.mozilla.org/".

Wenn zwei oder mehr Erweiterungen diesen Wert setzen, hat die am kürzesten zuvor installierte 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 spezifischere Suchanfragen wie die Bildsuche. Verwenden Sie in der angegebenen URL {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 eingebauten Anbietern präsentiert. Wenn Sie die Eigenschaft is_default hinzufügen und auf true setzen, wird der neue Suchanbieter die Standardoption sein. Durch die Angabe der Eigenschaft keyword 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: URL, die von der Suchmaschine verwendet wird. Dies muss eine HTTPS-URL sein.
is_default Optional
Boolesch: Wahr, wenn die Suchmaschine die Standardwahl sein soll. In Firefox ist dies opt-in, und der Benutzer wird nur beim ersten Mal gefragt, wenn die Erweiterung installiert wird. Wird eine Suchmaschine später hinzugefügt, wird nicht erneut gefragt.
alternate_urls Optional
Array von Strings: Ein Array alternativer URLs, die anstelle von search_url verwendet werden können.
encoding Optional
String: Kodierung des Suchbegriffs, angegeben als Standard-Zeichensatzkodierungsname, wie beispielsweise "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 ein Pfad relativ zur Wurzel der Erweiterung sein, der auf ein in der Erweiterung bereitgestelltes Icon verweist.
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 Instant-Suche 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 eingebauten 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 Kompatibilität über mehrere Browser hinweg 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 Kompatibilität über mehrere Browser hinweg verwenden Sie stattdessen suggest_url.
suggest_url_post_params Optional
String: POST-Parameter, die an suggest_url gesendet werden.

Beispiel

Dieses Beispiel zeigt, wie man einen Suchanbieter einrichtet.

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