chrome.topSites

refresh date: 2026-09-25 robots: noindex

Description

Utilisez l'API chrome.topSites pour accéder aux sites les plus consultés qui s'affichent sur la page "Nouvel onglet". Cela n'inclut pas les raccourcis personnalisés par l'utilisateur.

Autorisations

topSites

Fichier manifeste

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 visitée, comme les raccourcis par défaut sur la page "Nouvel onglet".

Propriétés

  • titre

    chaîne

    Le titre de la page

  • url

    chaîne

    URL la plus visitée.

Méthodes

get()

Promise
chrome.topSites.get(
  callback?: function,
)
: Promise<MostVisitedURL[]>

Récupère une liste des sites les plus visités.

Paramètres

  • callback

    function facultatif

    Le paramètre callback se présente comme suit :

    (data: MostVisitedURL[]) => void

Renvoie

  • Promise<MostVisitedURL[]>

    Chrome 96 ou version ultérieure

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