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 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-Hinweis des Benutzeragenten, der die Präferenz des Benutzeragenten für reduzierte Transparenz anzeigt.

Wenn ein Server über den Accept-CH Header einem Client signalisiert, dass er Sec-CH-Prefers-Reduced-Transparency akzeptiert, kann der Client mit diesem Header antworten, um die Präferenz des Benutzers 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 verringern.

Dieser Header basiert auf der prefers-reduced-transparency Media-Query.

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 Benutzeragenten für reduzierte Transparenz. Diese wird oft aus der Einstellung 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 außerdem Critical-CH verwendet, um anzuzeigen, 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 mitzuteilen, dass sich die gelieferten Inhalte basierend auf diesem Header-Wert unterscheiden werden — selbst wenn die URL gleich bleibt —, sodass der Browser nicht einfach eine bestehende zwischengespeicherte Antwort verwenden sollte, sondern diese Antwort separat zwischenspeichern sollte. Jeder im Critical-CH Header angegebene Header sollte auch in den Accept-CH und Vary Headern vorhanden sein.

Der Client wiederholt automatisch die Anfrage (aufgrund des oben angegebenen Critical-CH), um dem Server über Sec-CH-Prefers-Reduced-Transparency mitzuteilen, 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 einbeziehen, es sei denn, das 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

BCD tables only load in the browser

Siehe auch