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". Ils n'incluent pas les raccourcis personnalisés par l'utilisateur.
Autorisations
topSites
Vous devez déclarer la propriété "topSites" l'autorisation dans le fichier manifeste de votre extension d'utiliser cette API.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
Exemples
Pour essayer cette API, installez l'exemple d'API topSites à partir de chrome-extension-samples. un dépôt de clés.
Types
MostVisitedURL
Objet encapsulant une URL la plus consultée, comme les raccourcis par défaut sur la page "Nouvel onglet".
Propriétés
-
titre
chaîne
Titre de la page
-
url
chaîne
URL la plus consultée.
Méthodes
get()
chrome.topSites.get(
callback?: function,
)
Permet d'obtenir la liste des principaux sites.
Paramètres
-
rappel
function facultatif
Le paramètre
callback
se présente comme suit:(data: MostVisitedURL[]) => void
-
données
-
Renvoie
-
Promise<MostVisitedURL[]>
Chrome 96 ou version ultérieureLes promesses sont prises en charge dans Manifest V3 et versions ultérieures, mais les rappels sont fournis pour rétrocompatibilité. Vous ne pouvez pas utiliser les deux sur le même appel de fonction. La la promesse est résolue avec le même type que celui transmis au rappel.