Spec-Zone.ru › Web APIs

Headers: метод get()

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

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

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

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

Метод get() интерфейса Headers возвращает байтовую строку всех значений заголовка внутри объекта Headers с заданным именем. Если запрошенный заголовок не существует в объекте Headers, он возвращает null.

По соображениям безопасности некоторые заголовки могут контролироваться только пользовательским агентом. К ним относятся запрещённые имена заголовков и запрещённые имена заголовков ответа.

Синтаксис

get(name)

Параметры

name

Имя HTTP-заголовка, значения которого нужно получить из объекта Headers. Если заданное имя не является именем HTTP-заголовка, этот метод генерирует исключение TypeError. Имя нечувствительно к регистру.

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

Последовательность String, представляющая значения полученного заголовка, или null, если заголовок не задан.

Примеры

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

const myHeaders = new Headers(); // Currently empty
myHeaders.get("Not-Set"); // Returns null

Вы можете добавить заголовок с помощью Headers.append, а затем получить его с помощью get():

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

Если для заголовка задано несколько значений, байтовая строка будет содержать все значения в порядке их добавления в объект Headers:

myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
myHeaders
  .get("Accept-Encoding")
  .split(",")
  .map((v) => v.trimStart()); // Returns [ "deflate", "gzip" ]

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

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

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
get
42До версии 57, get() возвращал только первое значение для указанного заголовка.
14
39До версии 52, get() возвращал только первое значение для указанного заголовка.
29До версии 44, get() возвращал только первое значение для указанного заголовка.
10.1
42До версии 57, get() возвращал только первое значение для указанного заголовка.
39До версии 52, get() возвращал только первое значение для указанного заголовка.
29До версии 43, get() возвращал только первое значение для указанного заголовка.
10.3
4.0До версии 7.0, get() возвращал только первое значение для указанного заголовка.
42До версии 57, get() возвращал только первое значение для указанного заголовка.

См. также

  • API сервисных рабочих процессов
  • Управление доступом к ресурсам (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/get

Spec-Zone.ru

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