browsingData.removeCookies()

Löscht die Cookies im Browser.

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

  • nur Cookies zu löschen, die nach einer bestimmten Zeit erstellt wurden
  • zu steuern, ob nur Cookies von normalen Webseiten gelöscht werden sollen oder auch Cookies, die von gehosteten Apps und Erweiterungen gesetzt wurden.

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

Syntax

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

Parameter

removalOptions

object. Ein browsingData.RemovalOptions-Objekt, welches verwendet werden kann, um nur Cookies zu löschen, die nach einer bestimmten Zeit erstellt wurden, und ob nur Cookies von normalen Webseiten gelöscht werden sollen oder auch Cookies, die von gehosteten Apps und Erweiterungen gesetzt wurden.

Rückgabewert

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

Beispiele

Cookies entfernen, die in der letzten Woche erstellt wurden:

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
  .removeCookies({ since: oneWeekAgo })
  .then(onRemoved, onError);

Alle Cookies entfernen:

Warnung: Die Verwendung der API zum Entfernen aller Cookies wird gleichzeitig alle lokalen Speicherobjekte (einschließlich derjenigen anderer Erweiterungen) löschen.

Wenn Sie alle Cookies entfernen möchten, ohne die lokalen Speicherfunktionen zu stören, verwenden Sie browser.cookies, um durch alle Cookie-Speicher zu iterieren und deren Inhalte zu entfernen.

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

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

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

Browser-Kompatibilität

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