history.search()

query

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

text

string. Suchverlaufseinträge anhand von URL und Titel. Der String wird an Leerraumgrenzen in separate Suchbegriffe aufgeteilt. Jeder Suchbegriff wird ohne Beachtung der Groß-/Kleinschreibung mit der URL und dem Titel des Verlaufselements verglichen. Das Verlaufselement wird zurückgegeben, wenn alle Suchbegriffe übereinstimmen.

Zum Beispiel, betrachten Sie dieses Element:

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-Datumsstring oder die Anzahl der Millisekunden seit der Epoche. 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-Datumsstring oder die Anzahl der Millisekunden seit der Epoche. 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 der abzurufenden Ergebnisse. Standardmäßig auf 100, mit einem Mindestwert von 1. Die Funktion gibt einen Fehler aus, wenn Sie ihr einen maxResults-Wert kleiner als 1 übergeben.

Ein Promise wird mit einem Array von Objekten des Typs history.HistoryItem erfüllt, wobei jedes Objekt ein einzelnes passendes Verlaufselement beschreibt. Die Elemente sind in umgekehrter chronologischer Reihenfolge sortiert.

Protokolliert die URL und die letzte Besuchszeit für alle Verlaufselemente, 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 Verlaufselemente:

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 letzten 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