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 以上版本

    Manifest V3 以上版本支援 Promise，但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。