Заголовки: Sec-CH-Prefers-Reduced-Transparency

Заголовок Sec-CH-Prefers-Reduced-Transparency

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

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

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

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

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

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

HTTP-заголовок Sec-CH-Prefers-Reduced-Transparency — это заголовок запроса и подсказка клиенту от пользовательского агента, указывающая на предпочтение пользовательского агента в отношении уменьшения прозрачности.

Если сервер сообщает клиенту через заголовок Accept-CH, что он принимает Sec-CH-Prefers-Reduced-Transparency, клиент может отправить этот заголовок, чтобы сообщить о предпочтении пользователя в отношении уменьшения прозрачности. Сервер может отправить клиенту соответствующим образом адаптированный контент — например, CSS или изображения, — чтобы уменьшить прозрачность содержимого.

Этот заголовок основан на медиазапросе prefers-reduced-transparency.

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

Синтаксис

Sec-CH-Prefers-Reduced-Transparency: <preference>

Директивы

<preference>: Предпочтение пользовательского агента в отношении уменьшения прозрачности. Обычно оно берется из настроек операционной системы. Значением этой директивы может быть no-preference или reduce.

Примеры

Использование Sec-CH-Prefers-Reduced-Transparency

Клиент отправляет серверу первоначальный запрос:

GET / HTTP/1.1
Host: example.com

Сервер отвечает, сообщая клиенту через Accept-CH, что он принимает Sec-CH-Prefers-Reduced-Transparency. В этом примере также используется Critical-CH, указывающий, что Sec-CH-Prefers-Reduced-Transparency считается критически важной подсказкой клиенту.

HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Transparency
Vary: Sec-CH-Prefers-Reduced-Transparency
Critical-CH: Sec-CH-Prefers-Reduced-Transparency

Примечание: Мы также указали Sec-CH-Prefers-Reduced-Transparency в заголовке Vary, чтобы сообщить браузеру, что отправляемое содержимое будет различаться в зависимости от значения этого заголовка — даже если URL останется прежним. Поэтому браузеру не следует просто использовать уже сохраненный в кэше ответ; вместо этого этот ответ нужно кэшировать отдельно. Каждый заголовок, указанный в заголовке Critical-CH, также должен присутствовать в заголовках Accept-CH и Vary.

Клиент автоматически повторяет запрос (поскольку выше указан Critical-CH), сообщая серверу через Sec-CH-Prefers-Reduced-Transparency о предпочтении пользователя в отношении уменьшения прозрачности:

GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Transparency: "reduce"

Клиент будет включать этот заголовок в последующие запросы в текущем сеансе, пока Accept-CH в ответах не изменится и не укажет, что сервер больше не поддерживает эту функцию.

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

Спецификация
Заголовки подсказок клиенту для медиавозможностей, основанных на предпочтениях пользователя> # sec-ch-prefers-reduced-transparency>

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

	Настольные компьютеры					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome для Android	Firefox для Android	Opera для Android	Safari для iOS	Samsung Internet	WebView для Android	WebView для iOS
`Sec-CH-Prefers-Reduced-Transparency`	119	119	Нет	105	Нет	119	Нет	79	Нет	Нет	119	Нет

См. также

© 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-Prefers-Reduced-Transparency