說明
使用 chrome.topSites
API 存取新分頁中顯示的熱門網站 (也就是最常造訪的網站)。但使用者自訂的捷徑不包括在內。
權限
topSites
您必須宣告「top 網站」擴充功能資訊清單中的權限,才能使用這個 API。
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
範例
如要試用這個 API,請安裝 chrome-extension-samples 提供的 top Sites API 範例 Cloud Storage 也提供目錄同步處理功能
類型
MostVisitedURL
這個物件會封裝最常造訪的網址,例如新分頁中的預設捷徑。
屬性
-
title
字串
頁面標題
-
網址
字串
最常造訪的網址。
方法
get()
Promise
chrome.topSites.get(
callback?: function,
)
取得熱門網站清單。
參數
-
回呼
函式 選用
callback
參數如下所示:(data: MostVisitedURL[]) => void
-
資料
-
傳回
-
Promise<MostVisitedURL[]>
Chrome 96 以上版本Promise 適用於 Manifest V3 及以上版本,但系統會為 回溯相容性您無法在同一函式呼叫中同時使用兩者。 保證會以傳遞至回呼的相同類型來解析。