En-tête Sec-CH-UA-Full-Version-List
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-UA-Full-Version-List est une indication du client sur l'agent utilisateur qui fournit les informations de marque et de version complète de l'agent utilisateur.
L'en-tête Sec-CH-UA-Full-Version-List fournit les informations de marque et de version complète pour chaque marque associée au navigateur, sous forme de liste séparée par des virgules.
L'en-tête peut inclure des « fausses » marques à n'importe quelle position et avec n'importe quel nom. C'est une fonctionnalité conçue pour empêcher les serveurs de rejeter directement les agents utilisateurs inconnus, obligeant les agents utilisateurs à mentir sur leur identité de marque.
Note :
Ceci est similaire à Sec-CH-UA, mais inclut le numéro de version complet au lieu du numéro de version significatif pour chaque marque.
| 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
Sec-CH-UA-Full-Version-List: "<brand>";v="<full version>", …
La valeur est une liste séparée par des virgules des marques dans la liste des marques de l'agent utilisateur, et de leur numéro de version complet associé.
Directives
<brand>-
Une marque associée à l'agent utilisateur, comme « Chromium », « Google Chrome ». Il peut s'agir d'une marque intentionnellement incorrecte comme
" Pas Une;Marque"ou"(Pas(Une:Marque"(la valeur réelle est susceptible de changer au fil du temps et d'être imprévisible). <full version>-
Un numéro de version complet, comme « 98.0.4750.0 ».
Description
Une marque est un nom commercial pour l'agent utilisateur, comme : Chromium, Opera, Google Chrome, Microsoft Edge, Firefox et Safari.
Un agent utilisateur peut avoir plusieurs marques associées.
Par exemple, Opera, Chrome et Edge sont tous basés sur Chromium, et fournissent les deux marques dans l'en-tête Sec-CH-UA-Full-Version-List.
L'en-tête permet au serveur de personnaliser sa réponse en fonction des marques partagées et des personnalisations spécifiques dans leurs versions respectives.
Exemples
Utiliser Sec-CH-UA-Full-Version-List
Un serveur demande l'en-tête Sec-CH-UA-Full-Version-List en incluant Accept-CH dans une réponse à toute requête du client, en utilisant le nom de l'en-tête souhaité comme jeton :
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Full-Version-List
Le client peut choisir de fournir l'indication et ajouter l'en-tête Sec-CH-UA-Full-Version-List aux requêtes suivantes, comme indiqué ci-dessous :
GET /ma/page HTTP/1.1
Host: exemple.site
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Full-Version-List: " Not A;Brand";v="99.0.0.0", "Chromium";v="98.0.4750.0", "Google Chrome";v="98.0.4750.0"
Sec-CH-UA-Platform: "Linux"
Spécifications
| Spécification |
|---|
| User-Agent Client Hints # sec-ch-ua-full-version-list |
Compatibilité des navigateurs
Voir aussi
- Indications du client
- L'API d'indications de l'agent utilisateur du client
- L'en-tête
Accept-CH - HTTP Caching : Vary et l'en-tête
Vary - Améliorer la confidentialité des utilisateur·ice·s et l'expérience des développeur·euse·s avec les indications de l'agent utilisateur du client (angl.) sur developer.chrome.com