history.search()

Syntax

let searching = browser.history.search(
  query                  // object
)

Parameter

query

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

text

string. Sucht Verlaufsobjekte nach URL und Titel. Der String wird an Leerzeichen in separate Suchbegriffe aufgeteilt. Jeder Suchbegriff wird fallunempfindlich 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 Datumsstring oder die Anzahl der Millisekunden seit dem Epoch-Zeitpunkt. Wenn es angegeben ist, schließt diese Option Ergebnisse aus, deren lastVisitTime vor diesem Zeitpunkt liegt. 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 dem Epoch-Zeitpunkt. Wenn es angegeben ist, 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 an Ergebnissen, die abgerufen werden sollen. Standardmäßig 100, mit einem Mindestwert von 1. Die Funktion wird einen Fehler auslösen, wenn maxResults mit einem Wert kleiner als 1 übergeben wird.

Rückgabewert

Ein Promise wird mit einem Array von Objekten vom Typ history.HistoryItem erfüllt, das jeweils ein einzelnes übereinstimmendes Verlaufsobjekt beschreibt. Die Objekte sind in umgekehrter chronologischer Reihenfolge sortiert.

Beispiele

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);

Beispielerweiterungen

• history-deleter

Browser-Kompatibilität