說明
使用 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,但是為了提供回溯相容性而提供的回呼。您無法在同一個函式呼叫中同時使用這兩者。承諾會用傳遞至回呼的同類型解析。