Заголовки

Интерфейс Headers из API Fetch позволяет выполнять различные действия с заголовками HTTP-запроса и ответа. Эти действия включают извлечение, установку, добавление и удаление заголовков из списка заголовков запроса.

Вы можете получить доступ к объекту Headers через свойства Request.headers и Response.headers, а также создать новый объект Headers с помощью конструктора Headers().

Объект Headers имеет связанный список заголовков, который изначально пуст и состоит из нуля или более пар имя-значение. Вы можете добавить в него элементы с помощью методов, таких как append() (см. Примеры). Во всех методах этого интерфейса имена заголовков сопоставляются по байтовым последовательностям без учета регистра.

Объект, реализующий Headers, может быть непосредственно использован в структуре for...of, вместо entries(): for (const p of myHeaders) эквивалентно for (const p of myHeaders.entries()).

У некоторых объектов Headers существуют ограничения на возможность изменения значения заголовков с помощью методов set(), delete() и append(). Ограничения на модификацию зависят от того, как был создан объект Headers.

• Для заголовков, созданных с помощью конструктора Headers(), ограничений на модификацию нет.
• Для заголовков объектов Request:
  • Если режим запроса mode равен no-cors, вы можете изменить любые заголовки запроса, разрешённые CORS.
  • В противном случае вы можете изменить любые незапрещённые заголовки.
• Для заголовков объектов Response:
  • Если ответ создан с помощью Response.error() или Response.redirect(), или получен из вызова fetch(), заголовки являются неизменяемыми и не могут быть изменены.
  • В противном случае, если ответ создан с помощью Response() или Response.json(), вы можете изменить любые незапрещённые заголовки ответа.

Все методы Headers выбросят исключение TypeError, если вы попытаетесь передать имя, которое не является валидным именем заголовка HTTP. Операции изменения выбросят исключение TypeError , если заголовок является неизменяемым. В любом другом случае они завершатся без ошибок.

Headers()

Создаёт новый объект Headers.

Headers.append()

Добавляет новое значение к существующему заголовку в объекте Headers, или добавляет заголовок, если он ещё не существует.

Headers.delete()

Удаляет заголовок из объекта Headers.

Headers.entries()

Возвращает итератор, позволяющий перебрать все пары ключ/значение, содержащиеся в этом объекте.

Headers.forEach()

Выполняет предоставленную функцию один раз для каждой пары ключ/значение в этом объекте Headers.

Headers.get()

Возвращает строковую последовательность всех значений заголовка в объекте Headers с заданным именем.

Headers.getSetCookie()

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

Headers.has()

Возвращает булево значение, указывающее, содержит ли объект Headers определённый заголовок.

Headers.keys()

Возвращает итератор, позволяющий перебрать все ключи пар ключ/значение, содержащихся в этом объекте.

Headers.set()

Устанавливает новое значение для существующего заголовка в объекте Headers или добавляет заголовок, если он ещё не существует.

Headers.values()

Возвращает итератор, позволяющий перебрать все значения пар ключ/значение, содержащихся в этом объекте.

В следующем фрагменте кода мы создаём новый заголовок с помощью конструктора Headers(), добавляем к нему новый заголовок с помощью append(), затем возвращаем значение этого заголовка с помощью get():

const myHeaders = new Headers();

myHeaders.append("Content-Type", "text/xml");
myHeaders.get("Content-Type"); // should return 'text/xml'

То же самое можно сделать, передав массив массивов или объект-литерал в конструктор:

let myHeaders = new Headers({
  "Content-Type": "text/xml",
});

// or, using an array of arrays:
myHeaders = new Headers([["Content-Type", "text/xml"]]);

myHeaders.get("Content-Type"); // should return 'text/xml'

• API ServiceWorker
• Управление доступом к HTTP (CORS)
• HTTP