chrome.topSites

说明

使用 chrome.topSites API 访问新标签页上显示的热门网站（即最常访问的网站）。这些不包括用户自定义的快捷方式。

权限

topSites

此权限会触发警告。

清单

您必须声明“topSites”扩展程序清单中授予使用此 API 的权限。

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

示例

若要试用此 API，请安装 chrome-extension-samples 中的 topSites API 示例 存储库

类型

MostVisitedURL

用于封装最常访问的网址（例如新标签页上的默认快捷方式）的对象。

属性

• 标题

  字符串

  网页的标题

• 网址

  字符串

  最常访问的网址。

方法

get()

<ph type="x-smartling-placeholder"></ph> 承诺

chrome.topSites.get(
  callback?: function,
)

获取热门网站列表。

参数

• callback

  函数（可选）

  callback 参数如下所示：

  (data: MostVisitedURL[]) => void

  • 数据

    MostVisitedURL[]

返回

• Promise&lt;MostVisitedURL[]&gt;

  Chrome 96 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。