Заголовки: Sec-CH-UA

Заголовок Sec-CH-UA

Ограниченная доступность

Эта функция не относится к Baseline, поскольку она не работает в некоторых наиболее широко используемых браузерах.

Хотите, чтобы эта функция поддерживалась в большем числе браузеров? Расскажите нам почему.

Подробнее
Полная информация о совместимости

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

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

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

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

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

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

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

Тип заголовка	Заголовок запроса, Клиентская подсказка
Запрещённый заголовок запроса	Да (префикс `Sec-`)

Синтаксис

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

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

Директивы

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

Описание

Бренд — это коммерческое название 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

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> # sec-ch-ua>

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

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

См. также

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