history.deleteRange()

Entfernt alle Seitenbesuche, die der Benutzer während des angegebenen Zeitbereichs gemacht hat. Wenn dadurch alle Besuche einer bestimmten Seite entfernt werden, wird die Seite nicht mehr im Browserverlauf angezeigt und history.onVisitRemoved wird dafür 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 Zeitbereichs, 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 dem Epoch. Gibt die Startzeit des Bereichs 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 dem Epoch. Gibt die Endzeit des Bereichs an.

Rückgabewert

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

Beispiele

Alle Besuche der letzten Minute löschen:

js
const MINUTE = 60 * 1000;

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

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

Browser-Kompatibilität

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