このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

CookieChangeEvent

Baseline 2025
最近利用可能

2025年6月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。

Want more browser support for this feature? Tell us why.

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

CookieChangeEventクッキーストアー API のインターフェイスで、Cookie が作成されたり削除されたりしたときに CookieStore で発行される change イベントのイベント型です。

メモ: 同じ名前・ドメイン・パスの他の Cookie が挿入されることにより置き換えられる Cookie は無視され、変更イベントは発生しません。

Event CookieChangeEvent

コンストラクター

CookieChangeEvent()

新しい CookieChangeEvent を生成します。

インスタンスプロパティ

このインターフェイスには Event から継承したプロパティもあります。

CookieChangeEvent.changed 読取専用

新しく作成されたすべてのクッキーを一覧にした配列です。なお、有効期限が過去の日付に設定されて作成されたクッキーは、直ちに削除されるため、この一覧には含まれません。

CookieChangeEvent.deleted 読取専用

有効期限が切れたか、明示的に削除されたために除去されたすべてのクッキーを一覧表示する配列です。なお、これには有効期限が過去の日付に設定されていたクッキーも含まれます。

インスタンスメソッド

このインターフェイスには Event から継承したメソッドもあります。

この例では、Cookie が設定されると、イベントリスナーがイベントをコンソールに記録します。これは今設定されたばかりの Cookie を表すオブジェクトが格納された changed プロパティを持つ CookieChangeEvent オブジェクトです。

js
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

ブラウザーの互換性