大网数据广告活动
Web 标准与前端开发

CookieStore:getAll() 方法

· 52CE 我爱测

CookieStore 接口的 **`getAll()`** 方法返回与传递给它的 `name` 或 `options` 匹配的所有 cookie 列表。不传递任何参数将返回当前上下文的所有 cookie。

Cookie Store API

CookieStore 接口的 getAll() 方法返回与传递给它的 name 或 options 匹配的所有 cookie 列表。不传递任何参数将返回当前上下文的所有 cookie。

语法

getAll(name)
getAll(options)

参数

  • name
    • : 记录 cookie 名称的字符串。

或

  • options
    • : 一个包括以下属性的对象:
      • name
        • : 记录 cookie 名称的字符串。
      • url
        • : 记录 cookie URL 的字符串。

[!NOTE] url 选项可以修改特定 URL 下的 cookie。Service Worker 在其作用域下可以获得发送至任何 URL 的 cookie。在文档中,你只能在当前 URL 处获取 Cookie,因此文档上下文中唯一有效的 URL 是文档的 URL。

返回值

一个兑现为与指定的 name 或 options 对象匹配的 cookie 信息对象的 Promise。

每一个对象包含以下属性:

  • domain

    • : 记录 cookie 域名的字符串。
  • expires

    • : Unix time(以毫秒为单位表示),记录 cookie 的到期日期。
  • name

    • : 记录 cookie 名称的字符串。
  • partitioned

  • path

    • : 记录 cookie 路径的字符串。
  • sameSite

    • : 以下 SameSite 的值之一:
      • "strict"
        • : Cookie 只会在第一方上下文中发送,不会与第三方网站发起的请求一起发送。
      • "lax"
        • : Cookie 不会在正常的跨站点子请求(例如将图像或框架加载到第三方站点)中发送,而是在用户在原始站点内导航时(即点击链接时)发送。
      • "none"
        • : Cookie 将会在所有上下文中发送。
  • secure

    • : 一个布尔值,表示 cookie 是否仅在安全上下文中使用(true)或(false)。
  • value

    • : 记录 cookie 的值的字符串。

异常

  • SecurityError DOMException
    • : 如果源无法被Serialization成 URL,则抛出该异常。
  • TypeError
    • : 以下情况抛出该异常:
      • 在主线程中使用时,指定的 url 选项与创建的 URL 不一致。
      • 指定的 url 选项的源与创建的 URL 的源不一致。
      • 通过 name 或 options 查询 Cookie 失败。

示例

在此示例中,我们不传递任何参数使用 getAll()。以对象数组的形式返回包含此上下文中所有 Cookie。

const cookies = await cookieStore.getAll();

if (cookies.length > 0) {
  console.log(cookies);
} else {
  console.log("Cookie 未找到");
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。