Spec-Zone.ru › Web APIs

Headers: метод set()

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

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

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

Примечание: Эта функция доступна в Веб-воркерах.

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

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

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

Синтаксис

set(name, value)

Параметры

name

Имя HTTP-заголовка, которое вы хотите установить с новым значением. Если заданное имя не является именем HTTP-заголовка, этот метод вызывает TypeError.

value

Новое значение, которое вы хотите установить.

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

Ничего (undefined).

Примеры

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

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

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

myHeaders.append("Content-Type", "image/jpeg");
myHeaders.set("Content-Type", "text/html");

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

myHeaders.set("Accept-Encoding", "deflate");
myHeaders.set("Accept-Encoding", "gzip");
myHeaders.get("Accept-Encoding"); // Returns 'gzip'

Для добавления нового значения к имеющимся потребовалось бы использовать Headers.append, а не перезаписывать.

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

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

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

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

См. также

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

Spec-Zone.ru

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