chrome.topSites

説明

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

権限

topSites

マニフェスト

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

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

例

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

型

MostVisitedURL

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

プロパティ

  • title

    文字列

    ページのタイトル

  • URL

    文字列

    最もアクセスされた URL。

メソッド

get()

Promise 
chrome.topSites.get(
  callback?: function,
): Promise<MostVisitedURL[]>

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

パラメータ

  • callback

    関数 省略可

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

    (data: MostVisitedURL[]) => void

戻り値

  • Promise<MostVisitedURL[]>

    Chrome 96 以降

    Promise は Manifest V3 以降でのみサポートされます。他のプラットフォームではコールバックを使用する必要があります。