chrome_settings_overrides

类型 对象
必需
清单版本 2 或更高
示例
json
"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 参数。

示例

此示例显示了如何设置搜索提供商。

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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。