chrome_url_overrides

类型 对象
必填
清单版本 2 或更高
示例
json
  "chrome_url_overrides" : {
    "newtab": "my-new-tab.html"
  }

使用 chrome_url_overrides 键为加载到各种特殊页面中的文档提供自定义替换,这些特殊页面通常由浏览器本身提供。

语法

chrome_url_overrides 键是一个对象,它可能具有以下属性

名称 类型 描述
bookmarks 字符串

为显示书签的页面提供替换。

history 字符串

为显示浏览历史记录的页面提供替换。

newtab 字符串

为“新标签页”中显示的文档提供替换。这是用户打开新标签页但未加载任何文档时显示的页面:例如,使用 Ctrl/Command+T 键盘快捷键。

替换以指向 HTML 文件的 URL 给出。该文件必须与扩展程序捆绑在一起:您不能在这里指定远程 URL。您可以将其指定为相对于扩展程序根文件夹,例如:“path/to/newtab.html”。

该文档可以像普通网页一样加载 CSS 和 JavaScript。在页面中运行的 JavaScript 可以访问与扩展程序后台脚本相同的 特权“browser.*” API

包含一个 <title> 的最佳做法,否则标签的标题将是“moz-extension://...” URL。

一个常见的用例是让用户定义一个新标签页:为此,请提供一个自定义的新标签页,该标签页导航到用户定义的页面。

如果两个或多个扩展都定义了自定义的新标签页,则最后安装或启用的扩展将使用其值。

要覆盖浏览器的主页,请使用“chrome_settings_overrides”。

所有属性都是 可本地化的

示例

json
"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}

浏览器兼容性

BCD 表格仅在浏览器中加载