Spec-Zone.ru › Web APIs

Заголовки: конструктор Headers()

Базовая линия Широко доступно

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках выполнения Web Workers.

Конструктор Headers() создает новый объект Headers.

Синтаксис

new Headers()
new Headers(init)

Параметры

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

Объект, содержащий любые HTTP-заголовки, которые вы хотите предварительно заполнить в объект Headers. Это может быть простой объект-литерал со значениями String, массив пар «имя-значение», где каждая пара — массив строк из 2 элементов; или существующий объект Headers. В последнем случае новый объект Headers копирует данные из существующего объекта Headers.

Примеры

Создание пустого объекта Headers простое:

const myHeaders = new Headers(); // Currently empty

Вы можете добавить заголовок, используя Headers.append:

myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'

Или вы можете добавить нужные заголовки при создании объекта Headers. В следующем фрагменте мы создаем новый объект Headers, добавляя некоторые заголовки, передав конструктору объект init в качестве аргумента:

const httpHeaders = {
  "Content-Type": "image/jpeg",
  "X-My-Custom-Header": "Zeke are cool",
};
const myHeaders = new Headers(httpHeaders);

Теперь вы можете создать другой объект Headers, передав ему первый объект Headers как его объект init:

const secondHeadersObj = new Headers(myHeaders);
secondHeadersObj.get("Content-Type"); // Would return 'image/jpeg' — it inherits it from the first headers object

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

const headers = [
  ["Set-Cookie", "greeting=hello"],
  ["Set-Cookie", "name=world"],
];
const myHeaders = new Headers(headers);

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

Спецификация
Fetch
# ref-for-dom-headers①

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
Headers 42 14 39 29 10.1 42 39 29 10.3 4.0 42

См. также

  • API сервисных рабочих потоков (ServiceWorker)
  • Контроль доступа к HTTP (CORS)
  • HTTP

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

Spec-Zone.ru

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