cookies.Cookie

cookies API の Cookie 型は HTTP cookie の情報を持ちます。

型

以下のプロパティを含むオブジェクトです。

domain

cookie の所属するドメイン (例えば "www.google.com" や "example.com") を示す文字列を持つ string 型です。

expirationDate省略可

cookie の有効期限を UNIX 時刻からの秒数で持つ number 型です。セッション cookie はこのプロパティを持っていません。

firstPartyDomain

cookie に関連付けられたファーストパーティドメインを表す文字列を格納している string 型です。 cookie の First-party isolation が無効の間は空文字列になります。詳細は First-party isolation をご覧ください。

hostOnly

boolean 型です。cookie がホストオンリークッキー (リクエストのホストが cookie の指定ドメインと完全一致している場合のみ送信) である場合に true 、でなければ false になります。

httpOnly

boolean 型です。 cookie に HttpOnly 属性 ( cookie をクライアント側スクリプトから参照できなくする属性) が付与されている場合に true 、でなければ false が格納されます。

name

cookie の名前が格納される string 型です。

path

cookie のパスが格納される string 型です。

secure

boolean 型です。 cookie に secure 属性(暗号化通信でのみ cookie を送信する属性)が付与されている場合に true 、でなければ false になります。

session

boolean 型です。 cookie がセッション cookie ( セッション限りで破棄される cookie )である場合に true 、でなければ false が付与されます。

storeId

この cookie が格納されている cookie ストアの ID を格納する string 型です。cookies.getAllCookieStores() (en-US)によって提供されます。

value

cookie の値を格納する string 型です。

ブラウザーの互換性

BCD tables only load in the browser

例

cookies API のほとんどは入力パラメータまたは戻り値の一部として使用される Cookie オブジェクトを含みます。例えば cookies.getAll() (en-US) は Cookie オブジェクトの配列を返します。

以下の例ではすべての cookie を取得し、コンソールログに Cookie オブジェクト中のいくつかのプロパティを出力します。

function logCookies(cookies) {
  for (cookie of cookies) {
    console.log(`Domain: ${cookie.domain}`);
    console.log(`Name: ${cookie.name}`);
    console.log(`Value: ${cookie.value}`);
    console.log(`Persistent: ${!cookie.session}`);
  }
}

var gettingAll = browser.cookies.getAll({});
gettingAll.then(logCookies);

メモ: この API は Chromium の chrome.cookies API に基づいています。 また、このドキュメントは cookies.json における Chromium のコードに基づいています。Microsoft Edge での実装状況は Microsoft Corporation から提供されたものであり、ここでは Creative Commons Attribution 3.0 United States License に従っています。