chrome_settings_overrides

Typ Object
Erforderlich 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 besitzen 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 Datei verweisen, die mit der Erweiterung gebündelt ist, wobei sie als URL relativ zur Datei manifest.json angegeben ist
  • eine entfernte URL sein, wie "https://developer.mozilla.org/".

Wenn zwei oder mehr Erweiterungen diesen Wert festlegen, 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 wird.

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 Bildersuche. In der bereitgestellten URL können Sie "{searchTerms}" verwenden, um den Suchbegriff in die URL zu interpolieren, 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. Durch die Bereitstellung der Eigenschaft keyword ermöglichen Sie dem Benutzer, Ihren Suchanbieter zu wählen, indem er das Schlüsselwort in die Such-/Adressleiste vor dem Suchbegriff 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: Die von der Suchmaschine verwendete URL. Dies muss eine HTTPS-URL sein.
is_default Optional
Boolean: Wahr, wenn die Suchmaschine die Standardwahl sein sollte. In Firefox ist dies opt-in und der Benutzer wird nur beim ersten Installieren der Erweiterung gefragt. 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 von search_url verwendet werden können.
encoding Optional
String: Kodierung des Suchbegriffs, angegeben als eine Standard-Zeichenkodierungsname, 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 verweisen, das innerhalb der Erweiterung als Pfad relativ zum Wurzelverzeichnis der Erweiterung bereitgestellt wird.
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. Nur in Firefox verfügbar, für optimale Kompatibilität mit anderen Browsern 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 mit anderen Browsern 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 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