chrome_settings_overrides

类型	`对象`
Mandatory	No
范例	`"chrome_settings_overrides" : { "homepage": "https://developer.mozilla.org/" },`

使用 chrome_settings_overrides key to override the browser's home page and add a new search engine.

句法

chrome_settings_overrides key is an object that may have the following properties:

名称类型描述

名称	类型	描述
`homepage`	`字符串`	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. 这是 localizable property .
`search_provider`	`对象`	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` ， 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 . `名称` 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 Optional` Boolean: True if the search engine should be the default choice. On Firefox, this is opt-in and the user will only be asked the first time the extension is installed. They will not be asked again if a search engine is added later. `alternate_urls Optional` Array of String: An array of alternative URLs that can be used 而不是 `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. This must be an HTTPS URL. `suggest_url_post_params Optional` String: POST parameters to send to `suggest_url` .


homepage


字符串

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.

这是 localizable property .


search_provider


对象

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 ， 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 .

名称
search_url
is_default Optional: Boolean: True if the search engine should be the default choice. On Firefox, this is opt-in and the user will only be asked the first time the extension is installed. They will not be asked again if a search engine is added later.
alternate_urls Optional: Array of String: An array of alternative URLs that can be used 而不是 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
image_url_post_params Optional: String: POST parameters to send to image_url .
instant_url Optional
instant_url_post_params Optional: String: POST parameters to send to instant_url .
keyword Optional
prepopulated_id Optional
search_url_post_params Optional: String: POST parameters to send to search_url .
suggest_url Optional
suggest_url_post_params Optional: String: POST parameters to send to suggest_url .

范例

This example shows how to set a search provider.

"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"
  }
}

浏览器兼容性

BCD tables only load in the browser

Found a problem with this page?

Edit on GitHub
Source on GitHub
Report a problem with this content on GitHub
Want to fix the problem yourself? See our Contribution guide .

最后修改： Jan 19, 2022 , 由 MDN 贡献者

浏览器扩展名
快速入门
概念
用户界面
如何
Firefox differentiators
JavaScript API
1. Browser support for JavaScript APIs
2. alarms
3. bookmarks
4. browserAction
5. browserSettings
6. browsingData
7. captivePortal
8. clipboard
9. 命令
10. contentScripts
11. contextualIdentities
12. Cookie
13. devtools
14. dns
15. downloads
16. events
17. extension
18. extensionTypes
19. find
20. history
21. i18n
22. identity
23. idle
24. management
25. menus
26. notifications
27. omnibox
28. pageAction
29. permissions
30. pkcs11
31. privacy
32. proxy
33. runtime
34. search
35. sessions
36. sidebarAction
37. storage
38. tabs
39. theme
40. topSites
41. 类型
42. userScripts
43. webNavigation
44. webRequest
45. windows
Manifest keys
1. 介绍
Extension Workshop
1. Develop
2. Publish
3. Manage
4. Enterprise
Contact us
Channels

内容表

chrome_settings_overrides

句法

范例

浏览器兼容性

Found a problem with this page?

相关话题