topSites

Utilisez l'API topSites pour obtenir un tableau contenant les pages que l'utilisateur a visitées  fréquemment.

Les navigateurs maintiennent ceci pour aider l'utilisateur à retourner à ces endroits facilement. Par exemple, Firefox fournit par défaut une liste des pages les plus visitées dans la page "Nouvel onglet".

Pour utiliser l'API topSites, vous devez disposez de l' API permission "topSites".

Types

topSites.MostVisitedURL
Un objet contenant le titre et l'URL d'un site web.

Méthodes

topSites.get()
Obtient un tableau contenant tous les sites répertoriés dans la page "Nouvel onglet" du navigateur. Notez que le nombre de sites renvoyés ici est spécifique au navigateur, et les sites particuliers retournés seront probablement spécifiques à l'utilisateur, en fonction de leur historique de navigation.

Compatibilité du Navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaSafariFirefox pour Android
MostVisitedURLChrome Support complet OuiEdge Support complet 79Firefox Support complet 52Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 52 — 79
getChrome Support complet OuiEdge Support complet 79Firefox Support complet 78
Notes
Support complet 78
Notes
Notes 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.
Support complet 52
Opera Support complet OuiSafari Aucun support NonFirefox Android Aucun support 52 — 79

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.topSites.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.