Modules

topSites.get()

Obtients un tableau contenant tous les sites répertoriés dans la page "Nouvel onglet" du navigateur.

La page "Nouvel onglet" est la page qui s'ouvre  lorsque l'utilisateur ouvre un nouvel onglet sans y changer immédiatement une page : par exemple, en utilisant le bouton "Ouvrir un nouvel onglet". Le navigateur remplit généralement cette liste avec les sites que l'utilisateur visite le plus souvent.

IL s'agit d'une fonction asynchrone qui renvoie une Promesse.

Syntaxe

var gettingTopSites = browser.topSites.get()

Paramètres

None.

Valeur retournée

Une Promesse. Ceci sera réalisé avec un tableau d'objets  MostVisitedURL, un pour chaque site listé dans la page "Nouvel onglet" du navigateur. Si une erreur se produit, la presse sera rejetée avec un message d'erreur.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Support simple Oui Non5252 Oui

Exemples

Ce code enregistre le titre et l'UL de tous les sites dans la page "Nouvel onglet" :

function logTopSites(topSitesArray) {
  for (topSite of topSitesArray) {
    console.log(`Title: ${topSite.title}, URL: ${topSite.url}`);
  }
}

function onError(error) {
  console.log(error);
}

var gettingTopSites = browser.topSites.get();
gettingTopSites.then(logTopSites, onError);

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.topSites.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,