CookieChangeEvent
Baseline 2025>
最近利用可能
2025年6月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
Want more browser support for this feature? Tell us why.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
CookieChangeEvent はクッキーストアー API のインターフェイスで、Cookie が作成されたり削除されたりしたときに CookieStore で発行される change イベントのイベント型です。
メモ: 同じ名前・ドメイン・パスの他の Cookie が挿入されることにより置き換えられる Cookie は無視され、変更イベントは発生しません。
コンストラクター
-
新しい
CookieChangeEventを生成します。
インスタンスプロパティ
このインターフェイスには Event から継承したプロパティもあります。
-
新しく作成されたすべてのクッキーを一覧にした配列です。なお、有効期限が過去の日付に設定されて作成されたクッキーは、直ちに削除されるため、この一覧には含まれません。
-
有効期限が切れたか、明示的に削除されたために除去されたすべてのクッキーを一覧表示する配列です。なお、これには有効期限が過去の日付に設定されていたクッキーも含まれます。
インスタンスメソッド
このインターフェイスには Event から継承したメソッドもあります。
例
この例では、Cookie が設定されると、イベントリスナーがイベントをコンソールに記録します。これは今設定されたばかりの Cookie を表すオブジェクトが格納された changed プロパティを持つ CookieChangeEvent オブジェクトです。
cookieStore.addEventListener("change", (event) => {
console.log(event);
});
const oneDay = 24 * 60 * 60 * 1000;
cookieStore.set({
name: "cookie1",
value: "cookie1-value",
expires: Date.now() + oneDay,
domain: "example.com",
});
仕様書
| 仕様書 |
|---|
| Cookie Store API> # CookieChangeEvent> |