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
Manifest
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 ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.