chrome_settings_overrides 键是一个对象,可能包含以下属性:
| 名称 |
类型 |
描述 |
homepage |
String |
定义用作浏览器主页的页面。
替换内容以 URL 的形式给出。该 URL 可以
- 指向扩展程序捆绑的文件,在这种情况下,它以相对于 manifest.json 文件的 URL 形式给出。
- 是一个远程 URL,例如“https://mdn.org.cn/”。
如果两个或多个扩展程序都设置了此值,则最后一个安装的扩展程序设置将优先。
要覆盖新标签页,请改用“chrome_url_overrides”。
这是一个 可本地化属性。
|
search_provider |
Object |
定义要添加到浏览器的搜索提供程序。
搜索提供程序具有名称和主要搜索 URL。可以提供备用 URL,包括更专业的搜索(如图片搜索)的 URL。在您提供的 URL 中,请使用 {searchTerms} 将搜索词插入到 URL 中,例如:https://www.discogs.com/search/?q={searchTerms}。您还可以提供要与搜索一起发送的 POST 参数。
搜索提供程序将与内置提供程序一起呈现给用户。如果您包含 is_default 属性并将其设置为 true,则新搜索提供程序将成为默认选项。通过提供 keyword 属性,用户可以通过在搜索/地址栏中输入关键字(后跟搜索词)来选择您的搜索提供程序。
这是一个包含以下属性的对象。所有字符串属性都可本地化。
name
- String:搜索引擎的名称,显示给用户。
search_url
- String:搜索引擎使用的 URL。这必须是 HTTPS URL。
is_default 可选
- Boolean:如果搜索引擎应为默认选项,则为 true。在 Firefox 中,这是选择加入的,用户将在首次安装扩展程序时被询问。如果稍后添加搜索引擎,则不会再次询问。
alternate_urls 可选
- String 数组:可以用来替换
search_url 的备用 URL 数组。
encoding 可选
- String:搜索词的编码,指定为标准字符编码名称,例如“UTF-8”。
favicon_url 可选
- String:指向搜索引擎图标的 URL。在 Manifest V2 中,这必须是绝对的 HTTP 或 HTTPS URL。在 Manifest V3 中,这必须引用扩展程序根目录下的相对路径提供的图标。
image_url 可选
- String:用于图片搜索的 URL。
image_url_post_params 可选
- String:要发送到
image_url 的 POST 参数。
instant_url 可选
- String:用于即时搜索的 URL。
instant_url_post_params 可选
- String:要发送到
instant_url 的 POST 参数。
keyword 可选
- String:搜索引擎的地址栏关键字。
prepopulated_id 可选
- 要使用的内置搜索引擎的 ID。
search_url_get_params 可选
- String:要发送到
search_url 的 GET 参数。仅在 Firefox 中可用,为获得最佳跨浏览器兼容性,请使用 search_url。
search_url_post_params 可选
- String:要发送到
search_url 的 POST 参数。
suggest_url 可选
- String:用于搜索建议的 URL。这必须是 HTTPS URL。
suggest_url_get_params 可选
- String:要发送到
suggest_url 的 GET 参数。仅在 Firefox 中可用,为获得最佳跨浏览器兼容性,请使用 suggest_url。
suggest_url_post_params 可选
- String:要发送到
suggest_url 的 POST 参数。
|
此示例演示了如何设置搜索提供程序。
"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"
}
}