topSites

topSites API を使うと、ユーザーがよく訪れるページをを含む配列を取得できます。

ブラウザーはユーザーがこれらの場所に簡単に戻れるようにこれを維持します。Firefoxでは既定で「新しいタブ」ページには最もよく訪れるページのリストが提供されます。

topSites API を使うには "topSites" の API パーミッション必要です。

topSites.MostVisitedURL
ウェブサイトのタイトルと URLを含むオブジェクト。

Methods

topSites.get()
ブラウザーの「新しいタブ」ページに載っているすべてのサイトの配列を取得します。ここで返されるサイトの数はブラウザー固有であり、返されるサイトは、ブラウザー履歴に基づいてユーザー固有であることに注意してください。

ブラウザ実装状況

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxOperaSafariAndroid 版 Firefox
MostVisitedURLChrome 完全対応 ありEdge 完全対応 79Firefox 完全対応 52Opera 完全対応 ありSafari 未対応 なしFirefox Android 完全対応 52
getChrome 完全対応 ありEdge 完全対応 79Firefox 完全対応 78
補足
完全対応 78
補足
補足 A user may disable the browser's "Top Sites" feature by toggling the "browser.newtabpage.activity-stream.feeds.system.topsites" preference. In this case, topSites.get() will always return a list of the most-visited sites, regardless of the value of the newtab parameter.
完全対応 52
Opera 完全対応 ありSafari 未対応 なしFirefox Android 完全対応 52

凡例

完全対応  
完全対応
未対応  
未対応
実装ノートを参照してください。
実装ノートを参照してください。

Example extensions

Acknowledgements

This API is based on Chromium's chrome.topSites API.

Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.