Sec-CH-Prefers-Reduced-Transparency

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, bevor Sie diese produktiv verwenden.

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

Der Sec-CH-Prefers-Reduced-Transparency User-Agent-Client-Hint Request-Header gibt die Präferenz des User-Agents für reduzierte Transparenz an.

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

Dieser Header ist an die prefers-reduced-transparency Media-Query angelehnt.

Header-Typ Request-Header, Client-Hint
Verbotener Header-Name ja

Syntax

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

Direktiven

<preference>

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

Beispiele

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 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 auch Sec-CH-Prefers-Reduced-Transparency im Vary-Header spezifiziert, um dem Browser anzuzeigen, dass der gelieferte Inhalt sich basierend auf diesem Header-Wert unterscheidet, selbst 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-Headern vorhanden sein.

Der Client wiederholt automatisch die Anfrage (aufgrund der 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 einbeziehen, es sei denn, die Accept-CH-Antworten ändern sich, um anzuzeigen, dass der Server ihn nicht mehr unterstützt.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch