history.search()

query

Ein Objekt, das angibt, wonach im Browserverlauf gesucht werden soll. Dieses Objekt hat die folgenden Felder:

text

string. Durchsucht Verlaufsobjekte nach URL und Titel. Der String wird an Leerraumgrenzen in separate Suchbegriffe aufgeteilt. Jeder Suchbegriff wird ohne Berücksichtigung der Groß- und Kleinschreibung mit der URL und dem Titel des Verlaufsobjekts verglichen. Das Verlaufsobjekt wird zurückgegeben, wenn alle Suchbegriffe übereinstimmen.

Zum Beispiel, betrachten Sie dieses Objekt:

URL: "http://example.org"

Titel: "Example Domain"

"http"              -> matches
"domain"            -> matches
"MAIN ample"        -> matches
"main tt"           -> matches
"main https"        -> does not match

Geben Sie einen leeren String ("") an, um alle history.HistoryItem Objekte abzurufen, die alle anderen Kriterien erfüllen.

startTime Optional

number oder string oder object. Ein Wert, der ein Datum und eine Uhrzeit angibt. Dies kann dargestellt werden als: ein Date Objekt, ein ISO 8601 Datumstring oder die Anzahl der Millisekunden seit dem Epoch. Wenn es angegeben wird, schließt diese Option Ergebnisse aus, deren lastVisitTime früher als diese Zeit ist. Wenn es weggelassen wird, ist die Suche auf die letzten 24 Stunden beschränkt.

endTime Optional

number oder string oder object. Ein Wert, der ein Datum und eine Uhrzeit angibt. Dies kann dargestellt werden als: ein Date Objekt, ein ISO 8601 Datumstring oder die Anzahl der Millisekunden seit dem Epoch. Wenn es angegeben wird, beschränkt diese Option die Ergebnisse auf diejenigen, die vor diesem Datum besucht wurden. Wenn es weggelassen wird, werden alle Einträge ab der Startzeit berücksichtigt.

maxResults Optional

number. Die maximale Anzahl von Ergebnissen, die abgerufen werden sollen. Standardmäßig 100, mit einem Mindestwert von 1. Die Funktion löst einen Fehler aus, wenn Sie einen maxResults-Wert kleiner als 1 übergeben.

Ein Promise wird mit einem Array von Objekten des Typs history.HistoryItem erfüllt, die jeweils einen einzelnen passenden Verlaufsobjekt beschreiben. Die Objekte sind in umgekehrter chronologischer Reihenfolge sortiert.

Protokolliert die URL und die letzte Besuchszeit für alle Verlaufsobjekte, die in den letzten 24 Stunden besucht wurden:

function onGot(historyItems) {
  for (const item of historyItems) {
    console.log(item.url);
    console.log(new Date(item.lastVisitTime));
  }
}

browser.history.search({ text: "" }).then(onGot);

Protokolliert die URL und die letzte Besuchszeit für alle jemals besuchten Verlaufsobjekte:

function onGot(historyItems) {
  for (const item of historyItems) {
    console.log(item.url);
    console.log(new Date(item.lastVisitTime));
  }
}

browser.history
  .search({
    text: "",
    startTime: 0,
  })
  .then(onGot);

Protokolliert die URL und die letzte Besuchszeit des jüngsten Besuchs einer Seite, die den String "mozilla" enthält:

function onGot(historyItems) {
  for (const item of historyItems) {
    console.log(item.url);
    console.log(new Date(item.lastVisitTime));
  }
}

browser.history
  .search({
    text: "mozilla",
    startTime: 0,
    maxResults: 1,
  })
  .then(onGot);

• history-deleter