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

CookieStore:set() 方法

· 52CE 我爱测

CookieStore 接口的 **`set()`** 方法通过给定的 `name` 和 `value` 或 `options` 对象设置 cookie。

Cookie Store API

CookieStore 接口的 set() 方法通过给定的 name 和 value 或 options 对象设置 cookie。

语法

set(name, value)
set(options)

参数

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

  • name
    • : 记录 cookie 名称的字符串。
  • value
    • : 表示 cookie 值的字符串。

或

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

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

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

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

      • path

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

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

        • : 表示 cookie 的值的字符串。

返回值

设置 Cookie 成功时兑现为 undefined 的 Promise。

异常

  • SecurityError DOMException
    • : 如果源无法被Serialization成 URL,则抛出该异常。
  • TypeError
    • : 如果通过给定的 name 和 value 或 options 设置 cookie 失败,则抛出该异常。

示例

以下示例通过传递一个带有 name, value, expires 和 domain 的对象设置 cookie。

const day = 24 * 60 * 60 * 1000;

cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + day,
  domain: "example.com",
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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