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
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
oderreduce
sein.
Beispiele
Verwendung von Sec-CH-Prefers-Reduced-Transparency
Der Client stellt eine erste Anfrage an den Server:
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/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:
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
- Client-Hints
- User-Agent Client Hints API
Accept-CH
- HTTP-Caching: Vary und der
Vary
-Header - Verbesserung der Privatsphäre der Nutzer und der Entwicklererfahrung mit User-Agent-Client-Hints (developer.chrome.com)