Sec-CH-Prefers-Reduced-Transparency header
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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
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-preferenceoderreducesein.
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, um anzugeben, dass Sec-CH-Prefers-Reduced-Transparency als kritischer Client-Hinweis 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 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:
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
| Spezifikation |
|---|
| User Preference Media Features Client Hints Headers # sec-ch-prefers-reduced-transparency |
Browser-Kompatibilität
Siehe auch
- Client-Hinweise
- User-Agent-Client-Hints-API
Accept-CH- HTTP-Caching: Vary und der
VaryHeader - Verbesserung der Benutzerprivatsphäre und Entwicklererfahrung mit User-Agent-Client-Hinweisen (developer.chrome.com)