history.getVisits()

Récupère des informations sur toutes les visites de l'URL donnée.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

js
var getting = browser.history.getVisits(
  details, // object
);

Paramètres

details

object.

url

string. L'URL pour laquelle récupérer les informations de visite.

Valeur retournée

Une Promise sera remplie avec un tableau d'objets history.VisitItem représentant chacun une visite à l'URL donnée. Les visites sont triées dans l'ordre chronologique inverse.

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
getVisits

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Exemples

Liste toutes les visites de la page la plus récemment visitée :

js
function gotVisits(visits) {
  console.log("Visit count: " + visits.length);
  for (visit of visits) {
    console.log(visit.visitTime);
  }
}

function listVisits(historyItems) {
  if (historyItems.length) {
    console.log("URL " + historyItems[0].url);
    var gettingVisits = browser.history.getVisits({
      url: historyItems[0].url,
    });
    gettingVisits.then(gotVisits);
  }
}

var searching = browser.history.search({
  text: "",
  startTime: 0,
  maxResults: 1,
});

searching.then(listVisits);

Note :

Cette API est basée sur l'API Chromium chrome.history. Cette documentation est dérivée de history.json dans le code de Chromium.

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.