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 Client-Hint des Benutzer-Agents, der die Präferenz des Benutzer-Agents für reduzierte Transparenz angibt.

Wenn ein Server über den Accept-CH-Header einem Client signalisiert, dass er Sec-CH-Prefers-Reduced-Transparency akzeptiert, kann der Client daraufhin mit diesem Header antworten, um die Benutzerpräferenz für reduzierte Transparenz anzuzeigen. Der Server kann dem Client entsprechend angepasste Inhalte senden — zum Beispiel CSS oder Bilder — um die Transparenz der Inhalte zu reduzieren.

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

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

Syntax

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

Direktiven

<preference>

Die Präferenz des Benutzer-Agents für reduzierte Transparenz. Diese wird oft aus den Einstellungen des zugrunde liegenden Betriebssystems entnommen. 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, was darauf hinweist, dass Sec-CH-Prefers-Reduced-Transparency als ein kritischer Client-Hint 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 Sec-CH-Prefers-Reduced-Transparency auch im Vary-Header angegeben, um dem Browser anzuzeigen, dass der gelieferte Inhalt auf der Grundlage dieses Header-Wertes unterschiedlich sein wird — selbst wenn die URL gleich bleibt —, sodass der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden und stattdessen diese Antwort separat zwischenspeichern sollte. Jeder im Critical-CH-Header aufgelistete Header sollte auch in den Accept-CH- und Vary-Headers vorhanden sein.

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

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 aufnehmen, es sei denn, Accept-CH ändert sich in den Antworten, um anzuzeigen, dass er 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