Spec-Zone.ru › Web APIs

Заголовки: метод getSetCookie()

Примечание: Эта функция доступна в Веб-воркерах.

Метод getSetCookie() интерфейса Headers возвращает массив, содержащий значения всех заголовков Set-Cookie, связанных с ответом. Это позволяет объектам Headers обрабатывать наличие нескольких заголовков Set-Cookie, что не было возможно до его реализации.

Этот метод предназначен для использования в серверных средах (например, Node.js). Браузеры блокируют доступ к заголовку Set-Cookie кодом JavaScript на стороне клиента, как требуется спецификацией Fetch, которая определяет Set-Cookie как запрещённое имя заголовка ответа, которое должно быть отфильтровано из любого ответа, доступного коду на стороне клиента.

Синтаксис

getSetCookie()

Параметры

Нет.

Возвращаемое значение

Массив строк, представляющих значения всех различных заголовков Set-Cookie , связанных с ответом.

Если заголовки Set-Cookie не установлены, метод вернёт пустой массив ([ ]).

Примеры

Как упоминалось выше, выполнение кода, подобного следующему, на стороне клиента не вернёт никаких результатов — Set-Cookie отфильтровывается из Headers, полученного через сеть.

fetch("https://example.com").then((response) => {
  console.log(response.headers.getSetCookie());
  // No header values returned
});

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

const headers = new Headers({
  "Set-Cookie": "name1=value1",
});

headers.append("Set-Cookie", "name2=value2");

headers.getSetCookie();
// Returns ["name1=value1", "name2=value2"]

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

Спецификация
Fetch
# dom-headers-getsetcookie

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

Рабочие столы Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
getSetCookie 113 113 112 99 17 113 112 76 17 23.0 113

См. также

  • HTTP
  • Set-Cookie

© 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/Headers/getSetCookie

Spec-Zone.ru

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