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: Dieses Feature ist verfügbar in Service Workers.

Die delete() Methode des CookieStore Interfaces löscht ein Cookie mit dem angegebenen name oder options Objekt. Die delete() Methode lässt das Cookie verfallen, indem das Datum auf eines in der Vergangenheit geändert wird.

Syntax

js
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. Standardmäßig null.

path Optional

Ein String, der einen Pfad enthält. Standardmäßig /.

partitioned Optional

Ein boolescher Wert, der standardmäßig false ist. Wenn er auf true gesetzt wird, 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 das Löschen 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 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.

js
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