browsingData.remove()

Entfernt die angegebenen Browserdaten.

Die zu entfernenden Browserdaten werden in der Option dataTypes angegeben, die ein browsingData.DataTypeSet-Objekt ist.

Sie können die Option removalOptions verwenden, die ein browsingData.RemovalOptions-Objekt ist, um zu steuern, wie weit in die Vergangenheit Daten entfernt werden sollen und ob Daten nur von normalen Webseiten oder auch von gehosteten Apps und Erweiterungen entfernt werden sollen.

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

Syntax

js
let removing = browser.browsingData.remove(
  removalOptions,            // RemovalOptions object
  dataTypes                  // DataTypeSet object
)

Parameter

removalOptions

object. Ein browsingData.RemovalOptions-Objekt, das verwendet werden kann, um zu steuern, wie weit in die Vergangenheit Daten entfernt werden sollen und ob Daten von gehosteten Web-Apps und Erweiterungen oder nur von normalen Webseiten entfernt werden sollen.

dataTypes

object. Ein browsingData.DataTypeSet-Objekt, das die zu entfernenden Datentypen beschreibt (z. B. Verlauf, Downloads, …).

Rückgabewert

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

Beispiele

Entfernen des Download- und Browserverlaufs 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
  .remove({ since: oneWeekAgo }, { downloads: true, history: true })
  .then(onRemoved, onError);

Entfernen des gesamten Download- und Browserverlaufs:

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

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

browser.browsingData
  .remove({}, { downloads: true, history: true })
  .then(onRemoved, onError);

Beispiel-Erweiterungen

Browser-Kompatibilität

BCD tables only load in the browser

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