chrome.topSites

説明

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

権限

topSites

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

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

例

この API を試すには、chrome-extension-samples から topSites API の例をインストールしてください。 できます。

型

MostVisitedURL

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

プロパティ

  • title

    文字列

    ページのタイトル

  • URL

    文字列

    最もアクセスの多い URL。

メソッド

get()

<ph type="x-smartling-placeholder"></ph> 約束 
chrome.topSites.get(
  callback?: function,
)

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

パラメータ

  • callback

    関数（省略可）

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

    (data: MostVisitedURL[]) => void

戻り値

  • Promise&lt;MostVisitedURL[]&gt;

    Chrome 96 以降

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