CookieStore: get() メソッド

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

get()CookieStore インターフェイスのメソッドは、与えられた名前またはオプションオブジェクトを持つ 1 つの Cookie を返します(下記参照)。このメソッドは渡された引数に最初に一致する Cookie を返します。

構文

js
get(name)
get(options)

引数

このメソッドは、以下のいずれかが必要です。

name

Cookie の名前が入っている文字列です。

または

options

オブジェクトは以下のプロパティを含みます。

name

Cookie の名前が入っている文字列です。

url

Cookie の URL が入っている文字列です。

メモ: 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 値のうちの何れかです。

"strict"

Cookie はファーストパーティのコンテキストにのみ送られ、サードパーティのウェブサイトに対するリクエストには送られません。

"lax"

Cookie は、通常のサイト間サブリクエスト(例えば、サードパーティーのサイトに画像やフレームを読み込むためのもの)には送信されませんが、ユーザーがオリジン間サイト内を移動しているとき(リンクを追跡するとき)には送信されます。

"none"

Cookie はすべてのコンテキストで、送信されます。

secure

論理値で、この Cookie が安全なコンテキストでのみ使用されるか (true) またはそうではないか (false) を示します。

value

この Cookie の値が入った文字列です。

例外

TypeError

与えられた nameoptions で表される Cookie の取得に失敗した場合に発生します。

この例では、"cookie1" という名前の Cookie を返します。もし Cookie が見つかれば、プロミスの結果は 1 つの Cookie の詳細を含むオブジェクトになります。

js
let cookie = cookieStore.get("cookie1");
if (cookie) {
  console.log(cookie);
} else {
  console.log("Cookie not found");
}

仕様書

Specification
Cookie Store API
# dom-cookiestore-get

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
get
domain in return value
expires in return value
name in return value
partitioned in return value
Experimental
path in return value
sameSite in return value
secure in return value
value in return value

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.