CookieStore: delete()-Methode

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Service Workers.

Die delete()-Methode der CookieStore-Schnittstelle löscht ein Cookie mit dem angegebenen name oder options-Objekt. Die delete()-Methode setzt das Ablaufdatum des Cookies, indem sie es auf ein Datum in der Vergangenheit ändert.

Syntax

delete(name)
delete(options)

Parameter

Diese Methode erfordert eines der folgenden:

name Optional: Ein String mit dem Namen eines Cookies.

Oder

options Optional

Ein Objekt, das Folgendes enthält:

name: Ein String mit dem Namen eines Cookies.
domain Optional: Ein String mit der Domain eines Cookies. Standardwert ist null.
path Optional: Ein String, der einen Pfad enthält. Standardwert ist /.
partitioned Optional: Ein boolescher Wert, der standardmäßig auf false gesetzt ist. Wenn auf true gesetzt, wird angegeben, dass das zu löschende Cookie ein partitioniertes Cookie ist. Weitere Informationen finden Sie unter Cookies Having Independent Partitioned State (CHIPS).

Rückgabewert

Ein Promise, das mit undefined aufgelöst wird, wenn die Löschung abgeschlossen ist.

Ausnahmen

SecurityError DOMException: Wird ausgelöst, wenn der Ursprung nicht zu einer URL serialisiert werden kann.
TypeError: Wird ausgelöst, wenn das Löschen des durch den angegebenen name oder options dargestellten Cookies fehlschlägt.

Beispiele

In diesem Beispiel wird ein Cookie gelöscht, indem der Name an die delete()-Methode übergeben wird.

const result = cookieStore.delete("cookie1");

console.log(result);

Spezifikationen

Specification
Cookie Store API # dom-cookiestore-delete

Browser-Kompatibilität

BCD tables only load in the browser