Headers: метод get()
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.
Примечание: Эта функция доступна в Web Workers.
Метод get() интерфейса Headers возвращает байтовую строку всех значений заголовка внутри объекта Headers с заданным именем. Если запрошенный заголовок не существует в объекте Headers, он возвращает null.
По соображениям безопасности некоторые заголовки могут контролироваться только пользовательским агентом. К ним относятся запрещённые имена заголовков и запрещённые имена заголовков ответа.
Синтаксис
get(name)
Параметры
Возвращаемое значение
Последовательность 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() возвращал только первое значение для указанного заголовка. |
См. также
© 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