chrome.topSites

说明

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

权限

topSites

您必须在扩展程序清单中声明“topSites”权限，才能使用此 API。

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

示例

如需试用此 API，请从 chrome-extension-samples 代码库安装 topSites API 示例。

类型

MostVisitedURL

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

属性

• title

  string

  网页的标题

• 网址

  string

  最常访问的网址。

方法

get()

Promise

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

获取热门网站列表。

参数

• callback

  函数（可选）

  callback 参数如下所示：

  (data: MostVisitedURL[])=>void

  • data

    MostVisitedURL[]

返回

• Promise<MostVisitedURL[]>

  Chrome 96 及更高版本

  Manifest V3 及更高版本支持 promise，但提供回调以实现向后兼容性。您不能在同一个函数调用中同时使用这两者。promise 使用传递给回调函数的同一类型进行解析。