Skip to content

Commit cb3956d

Browse files
authored
zh-cn: translate for CookieStoreManager (#20346)
1 parent ba5eb02 commit cb3956d

File tree

1 file changed

+46
-0
lines changed
  • files/zh-cn/web/api/cookiestoremanager

1 file changed

+46
-0
lines changed
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
---
2+
title: CookieStoreManager
3+
slug: Web/API/CookieStoreManager
4+
l10n:
5+
sourceCommit: 60c3843f55839380e0c0cdc293ea694fe9943158
6+
---
7+
8+
{{securecontext_header}}{{APIRef("Cookie Store API")}}{{AvailableInWorkers("window_and_service")}}
9+
10+
{{domxref("Cookie Store API", "", "", 1)}} 的 **`CookieStoreManager`** 接口允许 Service Worker 订阅 cookie 变更事件。调用特定的 Service Worker Registration 的 {{domxref("CookieStoreManager.subscribe()","subscribe()")}} 方法接收变更事件。
11+
12+
`CookieStoreManager` 关联一个的 {{domxref("ServiceWorkerRegistration", "", "", 1)}}。每个 Service Worker Registration 包含一个 cookie 变更订阅列表,每个订阅都包含名称和 URL。此接口的方法允许 Service Worker 添加和移除订阅,以及获取所有订阅。
13+
14+
调用 {{domxref("ServiceWorkerRegistration.cookies")}} 获取 `CookieStoreManager`
15+
16+
## 实例方法
17+
18+
- {{domxref("CookieStoreManager.getSubscriptions()")}}
19+
- : 返回一个兑现为此 Service Worker Registration 的 cookie 变更订阅列表的 {{jsxref("Promise")}}。
20+
- {{domxref("CookieStoreManager.subscribe()")}}
21+
- : 订阅 cookie 变更。返回一个订阅后兑现为 {{jsxref("undefined")}} 的 {{jsxref("Promise")}}。
22+
- {{domxref("CookieStoreManager.unsubscribe()")}}
23+
- : 取消订阅 cookie 变更。返回一个操作成功后兑现为 {{jsxref("undefined")}} 的 {{jsxref("Promise")}}。
24+
25+
## 示例
26+
27+
在此示例中,被 `registration` 指示的 {{domxref("ServiceWorkerRegistration")}} 订阅了 `"/path1"` 作用域下命名为 `"cookie1"` 的 cookie 的变更事件。
28+
29+
```js
30+
const subscriptions = [{ name: "cookie1", url: `/path1` }];
31+
await registration.cookies.subscribe(subscriptions);
32+
```
33+
34+
如果 {{domxref("ServiceWorkerRegistration")}} 已经订阅了任何 cookie,{{domxref("CookieStoreManager.getSubscriptions()","getSubscriptions()")}} 将返回一个订阅时使用的对象匹配的 cookie 列表。
35+
36+
```js
37+
const subscriptions = await self.registration.cookies.getSubscriptions();
38+
```
39+
40+
## 规范
41+
42+
{{Specifications}}
43+
44+
## 浏览器兼容性
45+
46+
{{Compat}}

0 commit comments

Comments
 (0)