history.getVisits()

Ruft Informationen zu allen Besuchen der angegebenen URL ab.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let getting = browser.history.getVisits(
  details                // object
)

Parameter

details

Ein Objekt mit den folgenden Eigenschaften:

url

string. Die URL, für die Besuchsinformationen abgerufen werden sollen.

Rückgabewert

Ein Promise wird mit einem Array von history.VisitItem-Objekten erfüllt, die jeweils einen Besuch der angegebenen URL darstellen. Besuche sind in umgekehrt chronologischer Reihenfolge sortiert.

Browser-Kompatibilität

Beispiele

Liste alle Besuche der zuletzt besuchten Seite auf:

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

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

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

searching.then(listVisits);

Hinweis: Diese API basiert auf Chromiums chrome.history API. Diese Dokumentation stammt aus history.json im Chromium-Code.