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",
});
Спецификации
Совместимость с браузерами
| Рабочий стол | Мобильный телефон | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| 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