En-tête Sec-CH-Prefers-Reduced-Transparency

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

L'en-tête de requête HTTP Sec-CH-Prefers-Reduced-Transparency est une indication client qui indique la préférence de l'agent utilisateur pour une transparence réduite.

Si un serveur signale à un client avec l'en-tête Accept-CH qu'il accepte Sec-CH-Prefers-Reduced-Transparency, le client peut alors répondre avec cet en-tête pour indiquer la préférence de l'utilisateur·ice pour une transparence réduite. Le serveur peut envoyer au client un contenu adapté en conséquence — par exemple, du CSS ou des images — pour réduire la transparence du contenu.

Cet en-tête est basé sur la requête média prefers-reduced-transparency.

Type d'en-tête	En-tête de requête, Indication du client
En-tête de requête interdit	Oui (préfixe `Sec-`)

Syntaxe

http

Sec-CH-Prefers-Reduced-Transparency: <preference>

Directives

<preference>: La préférence de l'agent utilisateur pour une transparence réduite. Cela provient souvent du paramètre correspondant dans le système d'exploitation sous-jacent. La valeur de cette directive peut être soit no-preference, soit reduce.

Exemples

Utiliser `Sec-CH-Prefers-Reduced-Transparency`

Le client effectue une requête initiale au serveur :

http

GET / HTTP/1.1
Host: example.com

Le serveur répond, indiquant au client avec Accept-CH qu'il accepte Sec-CH-Prefers-Reduced-Transparency. Dans cet exemple, Critical-CH est également utilisé, indiquant que Sec-CH-Prefers-Reduced-Transparency est considéré comme une indication client critique.

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

Note : Nous avons également défini Sec-CH-Prefers-Reduced-Transparency dans l'en-tête Vary, pour indiquer au navigateur que le contenu servi varie en fonction de la valeur de cet en-tête — même si l'URL reste la même — afin que le navigateur n'utilise pas simplement une réponse mise en cache existante et mette plutôt en cache cette réponse séparément. Chaque en-tête répertorié dans l'en-tête Critical-CH doit également être présent dans les en-têtes Accept-CH et Vary.

Le client réessaie automatiquement la requête (en raison de la spécification de Critical-CH ci-dessus), indiquant au serveur avec Sec-CH-Prefers-Reduced-Transparency qu'il a une préférence utilisateur·ice pour une transparence réduite :

http

GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Transparency: "reduce"

Le client inclut l'en-tête dans les requêtes suivantes de la session en cours, sauf si l'en-tête Accept-CH change dans les réponses pour indiquer qu'il n'est plus pris en charge par le serveur.