From 9966624015103d86a117f298c194fa410232fb78 Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Tue, 4 Jun 2024 09:26:27 +0800 Subject: [PATCH] [zh-cn]: create the translation of `cookies.getAllCookieStores()` method (#21062) Co-authored-by: A1lo --- .../api/cookies/getallcookiestores/index.md | 80 +++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md diff --git a/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md new file mode 100644 index 00000000000000..ce33bd688f52b2 --- /dev/null +++ b/files/zh-cn/mozilla/add-ons/webextensions/api/cookies/getallcookiestores/index.md @@ -0,0 +1,80 @@ +--- +title: cookies.getAllCookieStores() +slug: Mozilla/Add-ons/WebExtensions/API/cookies/getAllCookieStores +l10n: + sourceCommit: 43e3ff826b7b755b05986c99ada75635c01c187c +--- + +{{AddonSidebar}} + +{{WebExtAPIRef("cookies")}} API 的 **`getAllCookieStores()`** 方法返回所有 cookie 存储的列表。 + +这是一个返回 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise) 的异步函数。 + +## 语法 + +```js-nolint +let gettingStores = browser.cookies.getAllCookieStores() +``` + +### 参数 + +无。 + +### 返回值 + +一个 [`Promise`](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Promise),会兑现一个表示所有现有 cookie 存储的 {{WebExtAPIRef('cookies.CookieStore')}} 对象的数组。 + +## 浏览器兼容性 + +{{Compat}} + +## 示例 + +在下面的代码片段中,`getAllCookieStores()` 方法用于检索浏览器中当前可用的所有 cookie 存储,并打印每个 cookie 存储的 ID,以及当前共享对应的 cookie 存储的标签页。 + +```js +function logStores(cookieStores) { + for (const store of cookieStores) { + console.log(`Cookie 存储:${store.id}\n标签页 ID:${store.tabIds}`); + } +} + +browser.cookies.getAllCookieStores().then(logStores); +``` + +`cookieStores` 数组的每个成员都是一个 {{WebExtAPIRef("cookies.CookieStore")}} 对象。 + +{{WebExtExamples}} + +> **备注:** 此 API 基于 Chromium 的 [`chrome.cookies`](https://developer.chrome.com/docs/extensions/reference/cookies/#type-Cookie) API。本文档源自 Chromium 代码中的 [`cookies.json`](https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/cookies.json)。 + +