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

http
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 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 auch Critical-CH verwendet, was darauf hinweist, 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 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:

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 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