Spec-Zone.ru › Web APIs

Headers: метод append()

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

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

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

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

Метод append() интерфейса Headers добавляет новое значение к существующему заголовку внутри объекта Headers, или добавляет заголовок, если он еще не существует.

Разница между set() и append() заключается в том, что если указанный заголовок уже существует и допускает несколько значений, set() перезапишет существующее значение новым, а append() добавит новое значение в конец набора значений.

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

Синтаксис

append(name, value)

Параметры

name

Имя HTTP-заголовка, который нужно добавить к объекту Headers.

value

Значение HTTP-заголовка, которое нужно добавить.

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

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

См. также

  • 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/append

Spec-Zone.ru

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