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