Headers: метод append()
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2017 года.
Примечание: Эта функция доступна в Web Workers.
Метод append() интерфейса Headers добавляет новое значение к существующему заголовку внутри объекта Headers, или добавляет заголовок, если он еще не существует.
Разница между set() и append() заключается в том, что если указанный заголовок уже существует и допускает несколько значений, set() перезапишет существующее значение новым, а append() добавит новое значение в конец набора значений.
По соображениям безопасности некоторые заголовки могут управляться только пользовательским агентом. К ним относятся запрещенные имена заголовков и запрещенные имена заголовков ответа.
Синтаксис
append(name, value)
Параметры
Возвращаемое значение
None (undefined).
Примеры
Создание пустого объекта Headers простое:
const myHeaders = new Headers(); // Currently empty
Вы можете добавить заголовок в него, используя append():
myHeaders.append("Content-Type", "image/jpeg");
myHeaders.get("Content-Type"); // Returns 'image/jpeg'
Если указанный заголовок уже существует, append() изменит его значение на указанное значение. Если указанный заголовок уже существует и допускает несколько значений, append() добавит новое значение в конец набора значений:
myHeaders.append("Accept-Encoding", "deflate");
myHeaders.append("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'
Чтобы перезаписать старое значение новым, используйте Headers.set.
Спецификации
| Спецификация |
|---|
| Fetch # ref-for-dom-headers-append① |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
append |
42 | 14 | 39 | 29 | 10.1 | 42 | 39 | 29 | 10.3 | 4.0 | 42 |
См. также
© 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/append