Spec-Zone.ru › Web APIs

CookieChangeEvent: изменённое свойство

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из самых широко используемых браузеров.

  • Узнать больше
  • Посмотреть полную совместимость
  • Отправить отзыв

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Свойство changed только для чтения интерфейса CookieChangeEvent возвращает массив изменённых файлов cookie.

Обратите внимание, что это исключит файлы cookie, созданные с датой истечения в прошлом, поскольку эти файлы cookie немедленно удаляются.

Значение

Массив объектов, содержащих изменённый(ые) файл(ы) cookie. Каждый объект содержит следующие свойства:

name

Строка, содержащая имя файла cookie.

value

Строка, содержащая значение файла cookie.

domain

Строка, содержащая домен файла cookie.

path

Строка, содержащая путь файла cookie.

expires

Отметка времени, заданная в временной шкале Unix в миллисекундах, содержащая дату истечения срока действия файла cookie.

secure

boolean, указывающий, используется ли файл cookie только в защищённом контексте (HTTPS, а не HTTP).

sameSite

Одно из следующих значений SameSite:

"strict"

Файлы cookie будут отправляться только в контексте первого уровня и не будут отправляться с запросами, инициированными сторонними веб-сайтами.

"lax"

Файлы cookie не отправляются при обычных межсайтовых подзапросах (например, для загрузки изображений или фреймов на сторонний сайт), но отправляются при навигации пользователя внутри сайта-источника (например, при переходе по ссылке).

"none"

Файлы cookie будут отправляться во всех контекстах.

partitioned

Булево значение, указывающее, является ли файл cookie разделенным (true) или нет (false). Дополнительную информацию см. в разделе Файлы cookie с независимым разделенным состоянием (CHIPS).

Примеры

В этом примере, при установке файла cookie, обработчик событий записывает свойство changed в консоль. Первый элемент в этом массиве содержит объект, представляющий файл cookie, который только что был установлен.

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

const one_day = 24 * 60 * 60 * 1000;
cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + one_day,
  domain: "example.com",
});

Спецификации

Спецификация
API хранилища файлов cookie
# dom-cookiechangeevent-changed

Совместимость с браузерами

Рабочий стол Мобильный телефон
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
changed 87 87 превью 73 Нет 87 Нет 62 Нет 14.0 87
partitioned_property 114 114 Нет 100 Нет 114 Нет 76 Нет 23.0 114

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CookieChangeEvent/changed

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API