CookieChangeEvent: deleted 屬性

基準線 2025
新推出

自 2025 年 6 月起,此功能已在最新的裝置和瀏覽器版本中可用。此功能可能不適用於舊裝置或瀏覽器。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

CookieChangeEvent 介面的只讀屬性 deleted 返回一個數組,其中包含由給定的 CookieChangeEvent 例項刪除的 cookie。

請注意,這也會包含那些建立時已過期(到期日期在過去)的 cookie,因為這些 cookie 會被立即刪除。

一個包含已刪除 cookie 的物件陣列。每個物件包含以下屬性:

name

包含 cookie 名稱的字串。

value

包含 cookie 值的字串。

包含 cookie 域名的字串。

路徑

包含 cookie 路徑的字串。

expires

一個時間戳,以 Unix 時間(毫秒)給出,包含 cookie 的過期日期。

secure

一個 boolean 值,指示 cookie 是否僅在安全上下文中(HTTPS 而不是 HTTP)使用。

sameSite

以下 SameSite 值之一:

"strict"

Cookie 將僅在第一方上下文中傳送,而不會與第三方網站發起的請求一起傳送。

"lax"

Cookie 不會在正常的跨站子請求中傳送(例如,在第三方網站中載入圖片或框架),但在使用者在源站內導航時(例如,在點選連結時)會發送。

"none"

Cookie 將在所有上下文中傳送。

partitioned

一個布林值,指示 cookie 是否為分割槽 cookie(true)或不是(false)。有關更多資訊,請參閱 具有獨立分割槽狀態的 Cookie (CHIPS)

示例

在此示例中,當 cookie 被刪除時,事件監聽器會將 CookieChangeEvent.deleted 屬性的第一個項記錄到控制檯。它包含一個代表剛剛被刪除的 cookie 的物件。

js
cookieStore.addEventListener("change", (event) => {
  console.log(event.deleted[0]);
});

規範

規範
Cookie Store API
# dom-cookiechangeevent-deleted

瀏覽器相容性