此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

CookieStore:delete() 方法

基线 2025
最近可用
*

自 2025年6月 起,此特性已在最新浏览器中得到支持。但在较旧的设备或浏览器中可能无法运行。

Want more browser support for this feature? Tell us why.

* 此特性的某些部分的支持程度可能有所不同。

安全上下文: 此特性仅在一些支持的浏览器的安全上下文(HTTPS)中可用。

备注: 此特性在 Web Worker 中可用。

CookieStore 接口的 delete() 方法通过 name 或 options 对象删除 cookie。delete() 方法通过将日期更改为过去的日期来使 cookie 过期。

语法

js
delete(name)
delete(options)

参数

此方法需要以下任意一个:

name 可选

记录 cookie 名称的字符串。

或

options 可选

一个包括以下属性的对象:

name

记录 cookie 名称的字符串。

domain 可选

记录 cookie 域名的字符串。默认为 null。

path 可选

记录 cookie 路径的字符串。默认为 /。

partitioned 可选

一个布尔值,默认为 false。将其设置为 true 指定要删除的 cookie 将是分区 cookie。更多信息请参阅具有独立分区状态的 Cookie(CHIPS)。

返回值

一个在删除完成后兑现为 undefined 的 Promise。

异常

SecurityError DOMException

如果源无法被序列化成 URL,则抛出该异常。

TypeError

如果删除给定 name 或 options 所表示的 cookie 失败,则抛出该异常。

示例

在此示例中,通过将 cookie 名称传递给 delete() 方法来删除 cookie。

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

console.log(result);

规范

规范
Cookie Store API
# dom-cookiestore-delete

浏览器兼容性