chrome_settings_overrides

この翻訳は不完全です。英語から この記事を翻訳 してください。

chrome_settings_overrides キーを使ってブラウザー設定を上書きします。2つの設定が利用できます:

  • "homepage"、これによりブラウザーのホームページを上書きできます。
  • "search_provider"、これにより新しい検索エンジンを追加できます。
"chrome_settings_overrides" : {
  "homepage": "https://developer.mozilla.org/"
}
"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"
  }
}
マニフェストキー: chrome_settings_overrides
Object
必須 No

構文

chrome_settings_overrides キーは次のプロパティを持つオブジェクトです:

名前 説明
homepage String

Defines the page to be used as the browser's homepage.

The replacement is given as a URL. The URL may:

  • point to a file bundled with the extension, in which case it is given as a URL relative to the manifest.json file
  • be a remote URL, such as "https://developer.mozilla.org/".

If two or more extensions both set this value, then the setting from the most recently installed one will take precedence.

To override new tabs, use "chrome_url_overrides" instead.

This is a localizable property.

search_provider Object

Defines a search provider to add to the browser.

The search provider has a name and a primary search URL. Alternative URLs may be provided, including URLs for more specialized searches like image search. In the URL you supply, use "{searchTerms}" to interpolate the search term into the URL, like: https://www.discogs.com/search/?q={searchTerms}. You can also provide POST parameters to be sent along with the search.

The search provider will be presented to the user alongside the built-in providers. If you include the is_default property and set it to true, the new search provider will be the default option. By supplying the keyword property, you enable the user to select your search provider by typing the keyword into the search/address bar before the search term.

This is an object with the properties listed below. All string properties are localizable.

name
String: The search engine's name, displayed to the user.
search_url
String: URL used by the search engine. This must be an HTTPS URL.
is_default
Boolean: True if the search engine should be the default choice.
alternate_urls Optional
Array of String: An array of alternative URLs that can be used instead of search_url.
encoding Optional
String: Encoding of the search term, specified as a standard character encoding name, such as "UTF-8".
favicon_url Optional
String: URL pointing to an icon for the search engine. This must be a absolute HTTP or HTTPS URL.
image_url Optional
String: URL used for image search.
image_url_post_params Optional
String: POST parameters to send to image_url.
instant_url Optional
String: URL used for instant search.
instant_url_post_params Optional
String: POST parameters to send to instant_url.
keyword Optional
String: Address bar keyword for the search engine.
prepopulated_id Optional
The ID of a built-in search engine to use.
search_url_post_params Optional
String: POST parameters to send to search_url.
suggest_url Optional
String: URL used for search suggestions.
suggest_url_post_params Optional
String: POST parameters to send to suggest_url.

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaAndroid 版 Firefox
基本対応Chrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
homepageChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_providerChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_provider.alternate_urlsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.encodingChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.favicon_urlChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_provider.image_urlChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.image_url_post_paramsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.instant_urlChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.instant_url_post_paramsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.is_defaultChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 57
補足
完全対応 57
補足
補足 The user is asked to opt into the default search change unless it is a built-in engine.
Opera 未対応 なしFirefox Android 未対応 なし
search_provider.keywordChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_provider.nameChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_provider.prepopulated_idChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.search_urlChrome 完全対応 ありEdge 未対応 なしFirefox 完全対応 55Opera 未対応 なしFirefox Android 未対応 なし
search_provider.search_url_post_paramsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.suggest_urlChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
search_provider.suggest_url_post_paramsChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし
startup_pagesChrome 完全対応 ありEdge 未対応 なしFirefox 未対応 なしOpera 未対応 なしFirefox Android 未対応 なし

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

ドキュメントのタグと貢献者

このページの貢献者: Uemmra3
最終更新者: Uemmra3,