chrome.topSites

說明

使用 chrome.topSites API 即可存取新分頁上顯示的熱門網站，例如最常造訪的網站。不包含使用者自訂的快速鍵。

權限

topSites

資訊清單

您必須在擴充功能資訊清單中宣告「topsites」權限，才能使用這個 API。

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

示例

如要試用這個 API，請從 chrome-extension-samples 存放區安裝 topsites API 範例。

類型

MostVisitedURL

這個物件會封裝使用者最常造訪的網址，例如新分頁上的預設快速鍵。

屬性

  • title

    字串

    網頁標題

  • url

    字串

    最常造訪的網址。

方法

get()

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

取得熱門網站清單。

參數

  • 回呼

    函式選用

    callback 參數如下所示： 

    (data: MostVisitedURL[])=>void

傳回

  • Promise<MostVisitedURL[]>

    Chrome 96 以上版本

    Promise 僅支援 Manifest V3 以上版本，其他平台就必須使用回呼。