Sec-CH-Prefers-Reduced-Transparency header

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Der HTTP Sec-CH-Prefers-Reduced-Transparency Request-Header ist ein User-Agent-Client-Hinweis, der die Präferenz des User-Agents für reduzierte Transparenz angibt.

Wenn ein Server einem Client über den Accept-CH-Header signalisiert, dass er Sec-CH-Prefers-Reduced-Transparency akzeptiert, kann der Client diesen Header verwenden, um die Benutzerpräferenz für reduzierte Transparenz anzugeben. Der Server kann dann entsprechend angepassten Inhalt — zum Beispiel CSS oder Bilder — senden, um die Transparenz des Inhaltes zu verringern.

Dieser Header ist dem prefers-reduced-transparency Media-Query nachempfunden.

Header-Typ Request-Header, Client-Hinweis
Verbotener Request-Header Ja (Sec- Präfix)

Syntax

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

Direktiven

<preference>

Die Präferenz des User-Agents für reduzierte Transparenz. Diese wird oft aus den Einstellungen des zugrunde liegenden Betriebssystems übernommen. Der Wert dieser Direktive kann entweder no-preference oder reduce sein.

Beispiele

Verwendung von Sec-CH-Prefers-Reduced-Transparency

Der Client stellt eine erste Anfrage an den Server:

http
GET / HTTP/1.1
Host: example.com

Der Server antwortet und teilt dem Client über Accept-CH mit, dass er Sec-CH-Prefers-Reduced-Transparency akzeptiert. In diesem Beispiel wird auch Critical-CH verwendet, um anzugeben, dass Sec-CH-Prefers-Reduced-Transparency als kritischer Client-Hinweis betrachtet wird.

http
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

Hinweis: Wir haben auch Sec-CH-Prefers-Reduced-Transparency im Vary-Header angegeben, um dem Browser zu signalisieren, dass der bereitgestellte Inhalt sich basierend auf diesem Header-Wert unterscheiden wird — auch wenn die URL gleich bleibt — daher sollte der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden, sondern diese Antwort separat zwischenspeichern. Jeder im Critical-CH Header aufgeführte Header sollte auch in den Accept-CH und Vary Headers vorhanden sein.

Der Client wiederholt automatisch die Anfrage (aufgrund der oben angegebenen Critical-CH) und teilt dem Server mit Sec-CH-Prefers-Reduced-Transparency mit, dass eine Benutzerpräferenz für reduzierte Transparenz besteht:

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

Der Client wird den Header in nachfolgenden Anfragen in der aktuellen Sitzung beibehalten, es sei denn, Accept-CH ändert sich in den Antworten, um anzuzeigen, dass es vom Server nicht mehr unterstützt wird.

Spezifikationen

Specification
User Preference Media Features Client Hints Headers
# sec-ch-prefers-reduced-transparency

Browser-Kompatibilität

Siehe auch