Sec-CH-UA

Экспериментально: Это экспериментальная технология
Перед использованием в производстве внимательно ознакомьтесь с таблицей совместимости с браузерами.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Заголовок запроса Sec-CH-UA клиентского подсказки user agent предоставляет информацию о бренде и значимой версии user-agent.

Тип заголовка	Заголовок запроса, Клиентская подсказка
Запрещённое имя заголовка	да

Заголовок Sec-CH-UA предоставляет список брендов и соответствующих значимых версий, разделенных запятыми.

Бренд — это коммерческое имя user-agent, например: Chromium, Opera, Google Chrome, Microsoft Edge, Firefox и Safari. У user-agent может быть несколько связанных брендов. Например, Opera, Chrome и Edge основаны на Chromium и предоставят оба бренда в заголовке Sec-CH-UA.

Значимая версия — это идентификатор "маркетинговой" версии, используемый для различения основных выпусков бренда. Например, сборка Chromium с полным номером версии "96.0.4664.45" имеет значимую версию "96".

Таким образом, заголовок позволяет серверу настраивать свой ответ, основываясь как на общих брендах, так и на конкретных настройках в их соответствующих версиях.

Заголовок Sec-CH-UA является подсказкой с низкой энтропией. Если не заблокировано политикой разрешений user-agent, он отправляется по умолчанию без необходимости включения сервера, отправив Accept-CH.

Заголовок может содержать «фиктивные» бренды в любой позиции и с любым именем. Это функция, разработанная для предотвращения прямого отклонения сервером неизвестных user-agent, заставляя user-agent скрывать свою принадлежность к бренду.

Примечание: Sec-CH-UA-Full-Version-List аналогичен Sec-CH-UA, но включает полный номер версии вместо значимой версии для каждого бренда.

Синтаксис

Список брендов в списке брендов user-agent, разделенных запятыми, и соответствующие значимые номера версии. Синтаксис для одной записи имеет следующий формат:

Sec-CH-UA: "<brand>";v="<significant version>", ...

Директивы

<brand>: Бренд, связанный с user-agent, например, "Chromium", "Google Chrome" или преднамеренно неправильный бренд, например, "Not A;Brand".
<significant version>: Номер "маркетинговой" версии, связанный с отличительными веб-функциями.

Примеры

Sec-CH-UA является подсказкой с низкой энтропией. Если не заблокировано политикой user-agent, он будет отправлен во всех запросах (без необходимости включения сервера, отправив Accept-CH).

Ниже приведены строки из браузеров Chromium, Chrome, Edge и Opera для настольных компьютеров. Обратите внимание, что они все разделяют бренд "Chromium", но имеют дополнительный бренд, указывающий на их происхождение. Также присутствует преднамеренно неправильная строка бренда, которая может появляться в любой позиции и иметь разный текст.

Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"

Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"

Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"

Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"

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

Спецификация
User-Agent Client Hints # sec-ch-ua

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

	Настольные						Мобильные
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`Sec-CH-UA`	89	89	Нет	Нет	75	Нет	89	89	Нет	63	Нет	15.0

См. также

© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Sec-CH-UA