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

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.