chrome_settings_overrides

Syntax

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

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 Remote-URL sein, beispielsweise "https://developer.mozilla.org/".

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

Verwenden Sie stattdessen chrome_url_overrides, um neue Tabs zu überschreiben.

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 stärker spezialisierte Suchen wie die Bildsuche. Verwenden Sie in der angegebenen URL {searchTerms}, um den Suchbegriff in die URL einzufügen, beispielsweise: https://www.discogs.com/search/?q={searchTerms}. Sie können außerdem POST-Parameter angeben, die zusammen mit der Suche gesendet werden sollen.

Der Suchanbieter wird dem Benutzer zusammen mit den integrierten Anbietern angezeigt. Wenn Sie die Eigenschaft is_default einschließen und auf true setzen, wird der neue Suchanbieter zur Standardoption. Durch 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.

Dieses Objekt hat die folgenden 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 Standardauswahl sein soll. In Firefox ist dies eine Opt-in-Funktion, und der Benutzer wird nur beim ersten Installieren der Erweiterung gefragt. Er wird nicht erneut gefragt, wenn später eine Suchmaschine hinzugefügt wird.

alternate_urls Optional

array von string. Ein Array alternativer URLs, die anstelle von search_url verwendet werden können.

encoding Optional

string. Kodierung des Suchbegriffs, angegeben als standardisierter Zeichenkodierungsname, beispielsweise „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 in der Erweiterung bereitgestelltes Symbol als Pfad relativ zum Stammverzeichnis 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 sofortige Suche verwendet wird.

instant_url_post_params Optional

string. POST-Parameter, die an instant_url gesendet werden.

keyword Optional

string. Schlüsselwort für die Adressleiste der Suchmaschine.

prepopulated_id Optional

string. 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; verwenden Sie für optimale Browser-Kompatibilität 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; verwenden Sie für optimale Browser-Kompatibilität 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.

"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