chrome.topSites

説明

chrome.topSites API を使用して、新しいタブページに表示される上位のサイト（最もアクセスの多いサイト）にアクセスします。ユーザーがカスタマイズしたショートカットは含まれません。

権限

topSites

この API を使用するには、拡張機能のマニフェストで「topSites」権限を宣言する必要があります。

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

例

この API を試すには、chrome-extension-samples リポジトリから topSites API の例をインストールします。

型

MostVisitedURL

新しいタブページのデフォルトのショートカットなど、よくアクセスする URL をカプセル化するオブジェクト。

プロパティ

  • title

    文字列

    ページのタイトル

  • URL

    文字列

    最もアクセスの多い URL。

Methods

get()

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

上位のサイトのリストを取得します。

パラメータ

  • callback

    関数（省略可）

    callback パラメータは次のようになります。 

    (data: MostVisitedURL[])=>void

戻り値

  • Promise<MostVisitedURL[]>

    Chrome 96 以降

    Promise は Manifest V3 以降でサポートされていますが、コールバックは下位互換性のために提供されています。同じ関数呼び出しで両方を使用することはできません。Promise は、コールバックに渡されたのと同じ型で解決されます。