-
Notifications
You must be signed in to change notification settings - Fork 8k
/
index.md
66 lines (50 loc) · 2.15 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
---
title: CookieChangeEvent:changed 属性
slug: Web/API/CookieChangeEvent/changed
l10n:
sourceCommit: a86c551ce8f5c6936b14640357eaa4da71a857d7
---
{{securecontext_header}}{{APIRef("Cookie Store API")}}
{{domxref("CookieChangeEvent")}} 接口的 **`changed`** 只读属性返回包含已被修改的 cookie 的数组。
## 值
包含被修改的 cookie 对象的数组。每个对象包含以下属性:
- `name`
- : 记录 cookie 名称的字符串。
- `value`
- : 记录 cookie 的值的字符串。
- `domain`
- : 记录 cookie 域名的字符串。
- `path`
- : 记录 cookie 路径的字符串。
- `expires`
- : {{glossary("Unix time", "Unix 时间戳")}}(以毫秒为单位表示),记录 cookie 的到期日期。
- `secure`
- : 一个{{jsxref("boolean", "布尔值", "", 1)}},指示 cookie 是否来自具有安全上下文(HTTPS 而不是 HTTP)的站点。
- `sameSite`
- : 以下 [`SameSite`](/zh-CN/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value) 的值之一:
- `"strict"`
- : Cookie 只会在第一方上下文中发送,不会与第三方网站发起的请求一起发送。
- `"lax"`
- : Cookie 不会在正常的跨站点子请求(例如将图像或框架加载到第三方站点)中发送,而是在用户在原始站点内导航时发送(例如,点击链接时)。
- `"none"`
- : Cookie 将被发送至所有上下文。
- `partitioned`
- : 一个布尔值,表示 cookie 是否是分区 cookie(`true`)或(`false`)。更多信息请参阅[具有独立分区状态的 Cookie(CHIPS)](/zh-CN/docs/Web/Privacy/Privacy_sandbox/Partitioned_cookies)。
## 示例
在以下示例中,当 cookie 被设置,事件监听器打印 `CookieChangeEvent.changed` 属性的第一个元素至控制台。这个元素代表刚刚设置的 cookie 对象。
```js
cookieStore.addEventListener("change", (event) => {
console.log(event.changed[0]);
});
const one_day = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + one_day,
domain: "example.com",
});
```
## 规范
{{Specifications}}
## 浏览器兼容性
{{Compat}}