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 verfallen, indem das Datum auf eines in der Vergangenheit geändert 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 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.

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