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