browsingData.removeHistory()

Löscht die Aufzeichnungen der vom Nutzer besuchten Webseiten (Browserverlauf).

Sie können den Parameter removalOptions verwenden, ein browsingData.RemovalOptions-Objekt, um:

  • nur Aufzeichnungen von Seiten zu entfernen, die nach einem bestimmten Zeitpunkt besucht wurden
  • zu steuern, ob nur Aufzeichnungen normaler Webseiten oder auch von gehosteten Apps und Erweiterungen gelöscht werden sollen.

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

Syntax

js
let removing = browser.browsingData.removeHistory(
  removalOptions            // RemovalOptions object
)

Parameter

removalOptions

object. Ein browsingData.RemovalOptions-Objekt, das verwendet werden kann, um nur Aufzeichnungen von Seiten zu löschen, die nach einem bestimmten Zeitpunkt besucht wurden, und um festzulegen, ob nur Aufzeichnungen normaler Webseiten oder auch von gehosteten Apps und Erweiterungen gelöscht werden sollen.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das Entfernen abgeschlossen ist. Falls ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Entfernen von Aufzeichnungen besuchter Seiten der letzten Woche:

js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

function weekInMilliseconds() {
  return 1000 * 60 * 60 * 24 * 7;
}

let oneWeekAgo = new Date().getTime() - weekInMilliseconds();

browser.browsingData
  .removeHistory({ since: oneWeekAgo })
  .then(onRemoved, onError);

Entfernen aller Aufzeichnungen besuchter Seiten:

js
function onRemoved() {
  console.log("removed");
}

function onError(error) {
  console.error(error);
}

browser.browsingData.removeHistory({}).then(onRemoved, onError);

Browser-Kompatibilität

Hinweis: Diese API basiert auf der chrome.browsingData API von Chromium.