このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
CookieStore: get() メソッド
Baseline 2025 *Newly available
Since June 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
* Some parts of this feature may have varying levels of support.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Experimental:これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
get() はCookieStore インターフェイスのメソッドは、与えられた名前またはオプションオブジェクトを持つ 1 つの Cookie を返します（下記参照）。このメソッドは渡された引数に最初に一致する Cookie を返します。
構文
get(name)get(options)引数
このメソッドは、以下のいずれかが必要です。
nameCookie の名前が入っている文字列です。
または
メモ:url オプションは、特定の URL をスコープとした Cookie の変更を可能にします。サービスワーカーは、自分のスコープ下にある任意の URL に送信される Cookie を取得できます。文書からは現在の URL の Cookie しか取得できないので、文書コンテキストで有効な URL は文書の URL のみとなります。
返値
与えられた名前またはオプションに一致する最初の Cookie を含むオブジェクトに解決されるPromise です。このオブジェクトは以下のプロパティを含んでいます。
domainCookie のドメインを含む文字列です。
expiresCookie の期限が入ったタイムスタンプで、ミリ秒単位のUnix 時刻です。
nameCookie の名前を含む文字列です。
partitioned論理値で、Cookie がパーティション化 Cookie であるか (
true) そうでないか (false) を表します。詳しくはCookies Having Independent Partitioned State (CHIPS) を参照してください。pathCookie のパスを含む文字列です。
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 |