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.

Want more browser support for this feature? Tell us why.

En savoir plus
Voir la compatibilité complète

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.