CookieChangeEvent: changed プロパティ
Baseline 2025
最近利用可能
2025年6月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
Want more browser support for this feature? Tell us why.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
changed は CookieChangeEvent インターフェイスの読み取り専用プロパティで、変更された Cookie の配列を返します。
なお、有効期限が過去の日付に設定されて作成されたクッキーは、即座に削除されるため、ここには含まれません。
値
オブジェクトの配列で、変更された Cookie が格納されています。それぞれのオブジェクトは以下のプロパティを持ちます。
name-
Cookie の名前を表す文字列です。
value-
Cookie の値を表す文字列です。
domain-
Cookie のドメインを表す文字列です。
path-
Cookie のパスを表す文字列です。
expires-
ミリ秒単位の UNIX 時間で与えられるタイムスタンプで、Cookie の有効期限を表します。
secure-
論理値 (
Boolean) で、Cookie が保護されたコンテキスト (HTTP ではなく HTTPS) でのみ使用されるかどうかを表します。 sameSite-
以下の
SameSiteの値のいずれかです。 partitioned-
クッキーが区画化されたクッキーであるか (
true)、そうでないか (false) を示す論理値です。情報については、個別区画化された状態を持つクッキー (CHIPS)を参照してください。
例
この例では、Cookie が設定されると、イベントリスナーがコンソールに changed プロパティを記録します。この配列の最初の要素には、設定されたばかりの Cookie を表すオブジェクトが格納されています。
cookieStore.addEventListener("change", (event) => {
console.log(event.changed[0]);
});
const oneDay = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + oneDay,
domain: "example.com",
});
仕様書
| 仕様書 |
|---|
| Cookie Store API # dom-cookiechangeevent-changed |