chrome.topSites

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()

Promesse 
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

Renvoie

  • Promise<MostVisitedURL[]>

    Chrome 96 et versions ultérieures

    Les 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.