CookieStore: delete() Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Hinweis: Diese Funktion ist in Service Workers verfügbar.

Die delete()-Methode des CookieStore-Interfaces löscht ein Cookie mit dem angegebenen name oder options-Objekt. Die delete()-Methode lässt das Cookie ablaufen, indem das Datum in die Vergangenheit gesetzt wird.

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 enthält:

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

Rückgabewert

Ein Promise, der mit undefined erfüllt wird, wenn das Löschen abgeschlossen ist.

Ausnahmen

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

Beispiele

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

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

console.log(result);

Spezifikationen

Specification
Cookie Store API # dom-cookiestore-delete

Browser-Kompatibilität

BCD tables only load in the browser