Изменяемое событие Cookie: изменённое свойство
Ограниченная доступность
Эта функция не является базовой, так как она не работает во всех распространённых браузерах.
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.
Примечание: Эта функция доступна только в рабочих потоках.
Свойство changed только для чтения интерфейса ExtendableCookieChangeEvent возвращает все cookie, которые были изменены данным экземпляром ExtendableCookieChangeEvent.
Значение
Массив объектов, содержащих изменённые 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.
self.addEventListener("cookiechange", (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/ExtendableCookieChangeEvent/changed