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 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 anzeigt.
Wenn ein Server dem Client über den Accept-CH
-Header 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 anzugeben. Der Server kann dann dem Client entsprechend angepassten Inhalt senden — zum Beispiel CSS oder Bilder — um die Transparenz des Inhalts zu reduzieren.
Dieser Header ist dem prefers-reduced-transparency
Media Query nachempfunden.
Header-Typ | Request-Header, Client-Hinweis |
---|---|
Verbotener Header-Name | 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 der Einstellung des zugrunde liegenden Betriebssystems übernommen. 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 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 anzuzeigen, dass der bereitgestellte Inhalt je nach Wert dieses Headers unterschiedlich sein wird — auch wenn die URL gleich bleibt —, sodass der Browser nicht einfach eine vorhandene zwischengespeicherte Antwort verwenden sollte, sondern diese Antwort separat zwischenspeichern sollte. Jeder Header, der im Critical-CH
-Header aufgeführt ist, sollte auch in den Accept-CH
- und Vary
-Headern vorhanden sein.
Der Client versucht die Anfrage automatisch erneut (da Critical-CH
oben angegeben wurde) und teilt dem Server über 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 aufnehmen, es sei denn, das Accept-CH
ändert sich in den Antworten, um anzuzeigen, dass es nicht mehr vom Server 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
- Client-Hinweise
- User-Agent Client Hints API
Accept-CH
- HTTP Caching: Vary und der
Vary
-Header - Improving user privacy and developer experience with User-Agent Client Hints (developer.chrome.com)