history.deleteRange()

Entfernt alle Besuche von Seiten, die der Benutzer während des angegebenen Zeitraums gemacht hat. Wenn dadurch alle Besuche einer bestimmten Seite entfernt werden, wird die Seite nicht mehr in der Browser-Historie angezeigt und history.onVisitRemoved wird ausgelöst.

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

Syntax

js
let deletingRange = browser.history.deleteRange(
  range           // object
)

Parameter

range

object. Spezifikation des Zeitraums, für den Besuche gelöscht werden sollen.

startTime

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. Gibt die Startzeit für den Zeitraum an.

endTime

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. Gibt die Endzeit für den Zeitraum an.

Rückgabewert

Ein Promise wird ohne Parameter erfüllt, wenn der Zeitraum gelöscht wurde.

Browser-Kompatibilität

Beispiele

Löschen Sie alle Besuche, die in der letzten Minute gemacht wurden:

js
const MINUTE = 60 * 1000;

function oneMinuteAgo() {
  return Date.now() - MINUTE;
}

browser.history.deleteRange({
  startTime: oneMinuteAgo(),
  endTime: Date.now(),
});

Hinweis: Diese API basiert auf der chrome.history-API von Chromium. Diese Dokumentation ist abgeleitet von history.json im Chromium-Code.