browsingData.removeHistory()

Löscht die Aufzeichnung von Webseiten, die der Nutzer besucht hat (Browsing-Verlauf).

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

  • nur Aufzeichnungen von nach einer bestimmten Zeit besuchten Webseiten zu löschen
  • zu steuern, ob nur Aufzeichnungen von normalen Webseiten oder auch Aufzeichnungen 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 nach einer bestimmten Zeit besuchten Webseiten zu löschen, und ob nur Aufzeichnungen von normalen Webseiten oder auch von gehosteten Apps und Erweiterungen gelöscht werden sollen.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn das Löschen abgeschlossen ist. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

Entfernen Sie Aufzeichnungen von in der letzten Woche besuchten Seiten:

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 Sie alle Aufzeichnungen von besuchten Seiten:

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

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

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

Browser-Kompatibilität

BCD tables only load in the browser

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