CookieStore: метод get()

Метод get() интерфейса CookieStore возвращает один cookie с заданным name или options объектом. Метод вернёт первый совпавший cookie для переданных параметров.

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

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

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

Или

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

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

name

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

url

Строка с URL cookie.

Объект Promise, который разрешается объектом, представляющим первый cookie, соответствующий переданному name или options. Этот объект содержит следующие свойства:

domain

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

expires

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

name

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

partitioned

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

path

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

sameSite

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

"strict"

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

"lax"

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

"none"

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

secure

Булево значение, указывающее, используется ли cookie только в безопасных контекстах (true) или нет (false).

value

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

SecurityError DOMException

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

TypeError

Выбрасывается, если:

• Параметр options является пустым объектом.
• Параметр url присутствует и не равен URL создания, если в основном потоке.
• Параметр url присутствует и его источник не совпадает с источником URL создания.
• Получение cookies, представленных данным name или options, не выполняется.

В этом примере мы возвращаем cookie с именем "cookie1". Если cookie найден, результатом Promise является объект, содержащий детали одного cookie.

const cookie = await cookieStore.get("cookie1");

if (cookie) {
  console.log(cookie);
} else {
  console.log("Cookie not found");
}