Essai d'abandon de la réduction user-agent
bookmark_border Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

La phase d'évaluation de l'abandon de la réduction de la chaîne user-agent permettait aux sites de continuer à recevoir la chaîne user-agent complète après la réduction de la chaîne UA. L'essai a pris fin le 23 septembre 2023.

À partir de Chrome 101, les informations disponibles dans la chaîne User-Agent (UA) seront réduites progressivement. Les sites qui n'ont pas eu le temps de passer de la chaîne user-agent réduite aux indicateurs client User-Agent peuvent participer à une phase d'évaluation de l'abandon pour continuer à recevoir la chaîne user-agent complète.

Les inscriptions à l'essai de l'abandon commenceront avec la version bêta de Chrome 100. Les sites pourront ainsi recevoir la chaîne user-agent complète avant la version Chrome 101, où la chaîne de version mineure sera réduite. Si vous souhaitez tester l'évaluation avant lancement sur la version bêta de Chrome 100 avant son lancement sur le canal stable, veillez à vous inscrire et à effectuer les tests avant la date de sortie de Chrome 100 (actuellement prévue pour le 31 mars 2022).

Vous trouverez ci-dessous une présentation de l'essai de l'abandon et de ce à quoi vous devez vous attendre. Si vous avez des commentaires à partager ou si vous rencontrez des problèmes au cours de ce test, faites-le nous savoir dans le dépôt GitHub sur la réduction de l'UA.

Qu'est-ce que cela signifie pour les développeurs Web ?

En s'inscrivant au test de l'abandon, les sites continueront de recevoir la chaîne UA complète dans navigator.userAgent et les valeurs non réduites dans les getters JavaScript navigator.platform et navigator.appVersion associés:

En-tête de requête HTTP User-Agent
Le getter JavaScript navigator.userAgent
Le getter JavaScript navigator.platform
Le getter JavaScript navigator.appVersion

Les sites doivent toujours auditer leur utilisation de l'en-tête User-Agent et des API associées, et si nécessaire, se préparer à passer aux hints client user-agent avant l'expiration de la période d'essai d'abandon. L'objectif est de mettre fin à cette phase d'évaluation de l'abandon une fois le déploiement de la réduction de la chaîne user-agent terminé.

Comment participer au test de l'abandon de la réduction user-agent ?

S'inscrire à l'essai

Pour vous inscrire à la phase d'évaluation et obtenir un jeton pour vos domaines, accédez à la page de la phase d'évaluation de l'abandon de la réduction de l'user-agent. Si vous êtes un tiers qui s'inscrit, cochez "Association tierce".

Configuration

Une fois que vous vous êtes inscrit au test, mettez à jour vos en-têtes de réponse HTTP avec les éléments suivants:

Ajoutez Origin-Trial: <ORIGIN TRIAL TOKEN> à votre en-tête de réponse HTTP. <ORIGIN TRIAL TOKEN> contient le jeton que vous avez reçu lorsque vous vous êtes inscrit au test d'origine.
Ajoutez Accept-CH: Sec-CH-UA-Full à votre en-tête de réponse HTTP. Le paramètre Accept-CH ne permet d'envoyer la chaîne User-Agent complète que dans les requêtes ultérieures envoyées à l'origine.
Si la chaîne User-Agent complète est essentielle lors de la première requête, ajoutez Critical-CH: Sec-CH-UA-Full à votre en-tête de réponse HTTP, en plus des en-têtes Accept-CH et Origin-Trial.
Pour les participants à la phase d'évaluation de l'abandon de la réduction, nous suggérons d'autoriser tous les domaines tiers à accéder à la chaîne user-agent complète. Si vous n'accordez pas l'accès à la chaîne user-agent complète aux domaines tiers, leur accès à la chaîne user-agent complète sera bloqué, quel que soit leur propre enregistrement de la phase d'évaluation de l'abandon de la réduction. Vous pouvez autoriser l'accès complet de la chaîne User-Agent aux domaines tiers de deux manières:
- Ajoutez un en-tête Permissions-Policy avec les domaines tiers qui doivent recevoir la chaîne User-Agent complète.
  - Pour autoriser tous les domaines tiers, ajoutez Permissions-Policy: ch-ua-full=*.
  - Pour autoriser une liste nommée de domaines tiers, ajoutez Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
- Ajoutez une balise méta Accept-CH avec les domaines tiers qui doivent recevoir la chaîne user-agent complète (uniquement dans Chrome 100 et versions ultérieures).
  - Pour autoriser une liste nommée de domaines tiers, ajoutez <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
  - Il n'est pas possible de déléguer à tous les domaines tiers via * dans la balise méta.
Chargez votre site Web dans Chrome 100 (ou version ultérieure) et continuez à recevoir la chaîne user-agent complète.

Démo

Consultez https://uard-ot-demo.glitch.me pour une démonstration du test (avec le code source).

Comment vérifier que l'essai fonctionne ?

Pour vérifier que le test d'origine fonctionne, examinez les en-têtes de requête et assurez-vous que les éléments suivants sont respectés:

L'en-tête User-Agent contient la version complète. Il ne doit contenir aucune des valeurs réduites (trouvées dans la liste d'exemples de chaînes User-Agent réduites). Pour le savoir facilement, notez que la chaîne de version mineure de Chrome ne doit pas être 0.0.0.
L'en-tête Sec-CH-UA-Full est défini sur ?1.

Les en-têtes de la réponse initiale contenant le jeton de test d'origine doivent se présenter comme suit:

Les en-têtes de requêtes suivants contenant la chaîne User-Agent complète doivent se présenter comme suit:

Comment arrêter de participer au test de l'abandon de la réduction de la chaîne user-agent ?

Vous pouvez à tout moment mettre fin à votre participation et recevoir la chaîne User-Agent réduite. Pour arrêter de participer:

Envoyez un en-tête Accept-CH dans votre réponse HTTP qui n'inclut pas Sec-CH-UA-Full. Notez que Accept-CH avec une valeur vide est un moyen valide d'y parvenir si votre site ne demande aucun autre indice client.
Supprimez l'en-tête Origin-Trial de votre réponse HTTP pour la phase d'évaluation de l'abandon de la réduction de l'user-agent.
Si défini, supprimez Sec-CH-UA-Full de l'en-tête Critical-CH dans votre réponse HTTP.

En quoi cette fonctionnalité diffère-t-elle des autres fonctionnalités d'origine de l'User-Agent ?

Chrome exécute deux phases d'évaluation pour les origines liées à la réduction de l'user-agent. La première était la phase d'évaluation de la réduction de l'user-agent, qui permettait aux sites de recevoir la chaîne user-agent réduite pour tester leurs cas d'utilisation et envoyer des commentaires avant qu'elle ne devienne le comportement par défaut dans Chrome.

La seconde, référencée ici, est une phase d'évaluation de l'abandon destinée aux sites qui ont besoin d'un peu plus de temps pour migrer vers l'API User-Agent Client Hints. Cela permet aux sites de continuer à recevoir la chaîne user-agent complète.

Combien de temps durera l'essai de l'abandon ?

L'abandon de la réduction de l'user-agent sera testé de Chrome 100 à Chrome 115. Chrome 116 sera la première version dans laquelle seule la chaîne user-agent réduite sera envoyée.

Comment envoyer des commentaires sur l'essai de dépréciation de la réduction user-agent ?

Signalez tout problème ou envoyez vos commentaires sur le dépôt GitHub de réduction de l'User-Agent.