CookieStore: метод set()

Метод set() интерфейса CookieStore устанавливает cookie с заданным name и value или options объектом.

Этот метод требует одного из следующих:

name Необязательно

Строка с именем cookie.

value Необязательно

Строка со значением cookie.

Или

options Необязательно

Объект, содержащий:

domain Необязательно

Строка, содержащая домен cookie. По умолчанию null.

expires Необязательно

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

name

Строка с именем cookie.

partitioned Необязательно

Булево значение, которое по умолчанию false. Если установлено в true, заданное cookie будет фрагментированным cookie. Подробнее см. Cookies Having Independent Partitioned State (CHIPS).

path Необязательно

Строка, содержащая путь cookie. По умолчанию /.

sameSite Необязательно

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

"strict"

Cookies будут отправляться только в контексте первого уровня и не будут отправляться вместе с запросами, инициированными веб-сайтами третьих сторон. Это значение по умолчанию.

"lax"

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

"none"

Cookies будут отправляться во всех контекстах.

value

Строка со значением cookie.

Обещание Promise, которое выполняется с undefined, когда установка cookie завершается.

SecurityError DOMException

Выбрасывается, если исходный контекст не может быть сериализован в URL.

TypeError

Выбрасывается, если установка cookie с заданным name и value или options не удаётся.

В следующем примере устанавливается cookie путём передачи объекта с name, value, expires, и domain.

const day = 24 * 60 * 60 * 1000;

cookieStore.set({
  name: "cookie1",
  value: "cookie1-value",
  expires: Date.now() + day,
  domain: "example.com",
});