chrome.topSites

更新日: 2026-09-25 robots: noindex

説明

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

    function 省略可

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

    (data: MostVisitedURL[]) => void

戻り値

  • Promise<MostVisitedURL[]>

    Chrome 96 以降

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