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". Ils n'incluent pas les raccourcis personnalisés par l'utilisateur.

Autorisations

topSites

Fichier manifeste

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

<ph type="x-smartling-placeholder"></ph> Promesse
chrome.topSites.get(
  callback?: function,
)

Permet d'obtenir la liste des principaux sites.

Paramètres

Renvoie

  • Promise&lt;MostVisitedURL[]&gt;

    Chrome 96 ou version ultérieure

    Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.