Overriding Chrome settings(覆盖 Chrome 设置)

警告 此页面直接从 MV2 文档集迁移而来。它尚未经过验证是否符合 Manifest V3。

设置覆盖是扩展程序覆盖所选 Chrome 设置的一种方式。该 API 在所有当前 Chrome 版本的 Windows 上可用，在 Mac 上的 Chrome 56 及更高版本上可用。

# Homepage, search provider, and startup pages(主页、搜索提供程序和启动页面)

以下是如何在扩展清单中修改主页homepage、搜索提供程序search provider和启动页面startup pages的示例。设置 API 中使用的网站必须经过验证verified（通过网站管理员工具）与 Chrome 网上应用店中的该项目相关联。请注意，如果您验证域的所有权（例如，https://example.com），您可以使用任何子域或页面（例如，https://app.example.com 或 https://example.com/ page.html) 在您的扩展程序中。

{
  "name": "My extension",
  ...
  "chrome_settings_overrides": {
    "homepage": "https://www.homepage.com",
    "search_provider": {
        "name": "name.__MSG_url_domain__",
        "keyword": "keyword.__MSG_url_domain__",
        "search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
        "favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
        "suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
        "instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
        "image_url": "https://www.foo.__MSG_url_domain__/image?q={searchTerms}",
        "search_url_post_params": "search_lang=__MSG_url_domain__",
        "suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
        "instant_url_post_params": "instant_lang=__MSG_url_domain__",
        "image_url_post_params": "image_lang=__MSG_url_domain__",
        "alternate_urls": [
          "https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
          "https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
        ],
        "encoding": "UTF-8",
        "is_default": true
    },
    "startup_pages": ["https://www.startup.com"]
   },
   "default_locale": "de",
   ...
}

# Customizing values(自定义值)

可以通过以下方式自定义清单中的值：

• search_provider、homepage 和 startup_pages 属性的所有值都可以使用 chrome.i18n API 进行本地化。

• 对于外部扩展，search_provider、homepage 和 startup_pages URL 值可以使用注册表项进行参数化。应该在“update_url”键旁边创建一个新的注册表项（请参阅此处here的说明）。值名称为“install_parameter”，值数据为任意字符串：

  {
    "update_url": "https://clients2.google.com/service/update2/crx",
    "install_parameter": "Value"
  }

  清单 URL 中所有出现的子字符串“__PARAM__”都将替换为“installparameter”值。如果不存在“installparameter”，则删除出现的“`_PARAM”。请注意，“\\_PARAM__`”不能是主机名的一部分。它需要出现在 URL 中的第一个“/”之后。

# Reference(参考)

扩展可以覆盖清单中的以下一个或多个属性：

• homepage (string) - optional

  主页的新值。

• search_provider (object) - optional

  一个搜索引擎

  Type	Attribute	Description
  string	(optional) name	向用户显示的搜索引擎名称。仅当设置了 prepopulated_id 时才可以省略。
  string	(optional) keyword	搜索引擎的多功能框关键字。仅当设置了 prepopulated_id 时才可以省略。
  string	(optional) favicon_url	搜索引擎的图标 URL。仅当设置了 prepopulated_id 时才可以省略。
  string	search_url	搜索引擎使用的搜索 URL。
  string	(optional) encoding	搜索词的编码。仅当设置了 prepopulated_id 时才可以省略。
  string	(optional) suggest_url	如果省略，则此引擎不支持建议。
  string	(optional) image_url	如果省略，则此引擎不支持图像搜索。
  string	(optional) search_url_post_params	search_url 的 post 参数字符串
  string	(optional) suggest_url_post_params	给suggest_url的post参数串
  string	(optional) image_url_post_params	image_url 的 post 参数字符串
  array of string	(optional) alternate_urls	除了 |search_url|之外，还可以使用的 URL 模式列表。
  integer	(optional) prepopulated_id	Chrome 中内置搜索引擎的 ID。
  boolean	is_default	指定搜索提供程序是否应为默认值。

• startup_pages (array of string) - optional

  一个长度为 1 的数组，包含要用作启动页面的 URL。

By.一粒技术服务.