chrome_settings_overrides

类型 Object
必填
Manifest 版本 2 或更高
示例
json
"chrome_settings_overrides" : {
  "homepage": "https://mdn.org.cn/"
 },

使用 chrome_settings_overrides 键可以覆盖浏览器的主页并添加新的搜索引擎。

语法

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 参数。

示例

此示例演示了如何设置搜索提供程序。

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

浏览器兼容性