CookieStore: getAll() メソッド
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
getAll()
は CookieStore
インターフェイスのメソッドで、渡された名前またはオプションに一致する Cookie のリストを返します。何も引数を渡さなければ、現在のコンテキストのすべての Cookie を返します。
構文
getAll(name)
getAll(options)
引数
name
省略可-
Cookie の名前が入っている文字列です。
または
options
省略可-
以下のプロパティを持つ文字列です。
メモ: url
オプションは、特定の URL をスコープとした Cookie の変更を可能にします。サービスワーカーは、自分のスコープ下にある任意の URL に送信される Cookie を取得できます。文書からは現在の URL の Cookie しか取得できないので、文書コンテキストで有効な URL は文書の URL のみとなります。
返値
指定された名前またはオプションに一致するクッキーを表すオブジェクトの配列で解決する Promise
です。
各オブジェクトは、以下のプロパティを持ちます。
domain
-
クッキーのドメインを持つ文字列です。
expires
-
クッキーの期限が入ったタイムスタンプで、ミリ秒単位の Unix 時刻です。
name
-
クッキーの名前が入った文字列です。
partitioned
-
論理値で、クッキーがパーティション化クッキーであるか (
true
) そうでないか (false
) を表します。詳しくは Cookies Having Independent Partitioned State (CHIPS) を参照してください。 path
-
クッキーのパスが入った文字列です。
sameSite
-
以下の
SameSite
値のうちの何れかです。 secure
-
論理値で、このクッキーが安全なコンテキストでのみ使用されるか (
true
) またはそうではないか (false
) を示します。 value
-
このクッキーの値が入った文字列です。
例外
TypeError
-
与えられた
name
やoptions
で表される Cookie の取得に失敗した場合にスローされます。
例
この例では、引数なしで getAll()
を使用しています。このコンテキストのすべての Cookie をオブジェクトの配列として返します。
let cookies = await cookieStore.getAll();
if (cookies) {
console.log(cookies);
} else {
console.log("Cookie not found");
}
仕様書
Specification |
---|
Cookie Store API # dom-cookiestore-getall |
ブラウザーの互換性
BCD tables only load in the browser