chrome_settings_overrides
类型 |
对象 |
必需 |
否 |
清单版本 |
2 或更高 |
示例 |
"chrome_settings_overrides" : {
"homepage": "https://mdn.org.cn/"
},
|
使用 chrome_settings_overrides
键覆盖浏览器的首页并添加新的搜索引擎。
chrome_settings_overrides
键是一个对象,它可能具有以下属性
名称 |
类型 |
描述 |
首页 |
字符串 |
定义用作浏览器首页的页面。
替换以 URL 的形式给出。URL 可以
- 指向与扩展捆绑在一起的文件,在这种情况下,它以相对于 manifest.json 文件的 URL 的形式给出
- 是一个远程 URL,例如“https://mdn.org.cn/”。
如果两个或多个扩展都设置了此值,则最近安装的扩展的设置将优先。
要覆盖新标签,请使用“chrome_url_overrides”代替。
这是一个可本地化的属性.
|
搜索提供商 |
对象 |
定义要添加到浏览器的搜索提供商。
搜索提供商具有名称和主要搜索 URL。可以提供备用 URL,包括用于更专门的搜索(如图像搜索)的 URL。在您提供的 URL 中,使用“{searchTerms} ”将搜索词插入 URL 中,例如:https://www.discogs.com/search/?q={searchTerms} 。您还可以提供要与搜索一起发送的 POST 参数。
搜索提供商将与内置提供商一起显示给用户。如果您包含 is_default 属性并将其设置为 true ,则新的搜索提供商将成为默认选项。通过提供 keyword 属性,您可以使用户能够在搜索词之前在搜索/地址栏中键入关键字来选择您的搜索提供商。
这是一个具有下面列出的属性的对象。所有字符串属性都是可本地化的.
名称
- 字符串:搜索引擎的名称,显示给用户。
search_url
- 字符串:搜索引擎使用的 URL。这必须是一个 HTTPS URL。
is_default 可选
- 布尔值:如果搜索引擎应该是默认选择,则为 true。在 Firefox 上,这是选择加入的,并且只会询问用户第一次安装扩展时。如果后来添加了搜索引擎,则不会再次询问他们。
alternate_urls 可选
- 字符串数组:可以代替
search_url 使用的备用 URL 数组。
encoding 可选
- 字符串:搜索词的编码,指定为标准字符编码名称,例如“UTF-8”。
favicon_url 可选
- 字符串:指向搜索引擎图标的 URL。在清单 V2 中,这必须是绝对 HTTP 或 HTTPS URL。在清单 V3 中,这必须引用扩展中提供的图标,作为相对于扩展根目录的路径。
image_url 可选
- 字符串:用于图像搜索的 URL。
image_url_post_params 可选
- 字符串:要发送到
image_url 的 POST 参数。
instant_url 可选
- 字符串:用于即时搜索的 URL。
instant_url_post_params 可选
- 字符串:要发送到
instant_url 的 POST 参数。
keyword 可选
- 字符串:搜索引擎的地址栏关键字。
prepopulated_id 可选
- 要使用的内置搜索引擎的 ID。
search_url_post_params 可选
- 字符串:要发送到
search_url 的 POST 参数。
suggest_url 可选
- 字符串:用于搜索建议的 URL。这必须是一个 HTTPS URL。
suggest_url_post_params 可选
- 字符串:要发送到
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"
}
}
BCD 表格仅在启用了 JavaScript 的浏览器中加载。