Description
Utilisez l'API chrome.topSites
pour accéder aux principaux sites (c'est-à-dire les sites les plus consultés) affichés sur la page "Nouvel onglet". Les raccourcis personnalisés par l'utilisateur ne sont pas concernés.
Autorisations
topSites
Pour utiliser cette API, vous devez déclarer l'autorisation"topSites" dans le fichier manifeste de votre extension.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
Exemples
Pour essayer cette API, installez l'exemple d'API topSites à partir du dépôt chrome-extension-samples.
Types
MostVisitedURL
Objet encapsulant une URL la plus consultée, comme les raccourcis par défaut sur la page "Nouvel onglet".
Propriétés
-
title
chaîne
Titre de la page
-
url
chaîne
URL la plus consultée.
Méthodes
get()
chrome.topSites.get(
callback?: function,
)
Récupère la liste des sites les plus visités.
Paramètres
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(data: MostVisitedURL[]) => void
-
data
MostVisitedURL (URL la plus visitée)[]
-
Renvoie
-
Promise<MostVisitedURL[]>
Chrome 96 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.