Premiers pas avec les phases d'évaluation

Tester une fonctionnalité de plate-forme Web nouvelle ou expérimentale

Sam Dutton

Les essais Origin Trial vous donnent accès à une fonctionnalité nouvelle ou expérimentale. Vous pouvez ainsi créer une fonctionnalité que vos utilisateurs peuvent essayer pendant une durée limitée avant qu'elle ne soit disponible pour tous.

Lorsque Chrome propose une phase d'évaluation pour une fonctionnalité, vous pouvez vous inscrire à la phase d'évaluation afin d'activer la fonctionnalité pour tous les utilisateurs de votre origine, sans qu'ils aient à activer ou désactiver les indicateurs ou à passer à une version alternative de Chrome (bien qu'ils doivent être mis à niveau). Les phases d'évaluation permettent aux développeurs de créer des démonstrations et des prototypes à l'aide de nouvelles fonctionnalités. Les tests aident également les ingénieurs Chrome à comprendre comment les nouvelles fonctionnalités sont utilisées et comment elles peuvent interagir avec d'autres technologies Web.

Les essais Origin sont publics et ouverts à tous les développeurs. Leur durée et leur utilisation sont limitées. La participation est un processus autogéré avec une documentation et une assistance limitées. Les participants doivent être prêts et capables de travailler de manière relativement autonome à l'aide de la documentation disponible, qui, à ce stade, sera probablement limitée aux spécifications et explications de l'API, bien que nous essayions de fournir des conseils dans la mesure du possible.

Si vous vous inscrivez à un essai, l'équipe Chrome vous demandera régulièrement des commentaires spécifiques sur votre utilisation de la fonctionnalité d'essai. Certaines fonctionnalités peuvent faire l'objet de plusieurs tests d'origine, car les commentaires sont intégrés et des ajustements sont effectués.

Les essais Origin Trial sont également disponibles pour Firefox et Microsoft Edge.

Tests d'origine tierce

Les essais d'origine ne sont généralement disponibles que pour les propriétaires: ils ne fonctionnent que pour une seule origine enregistrée. Les essais d'origine tiers permettent aux fournisseurs de contenus intégrés de tester une nouvelle fonctionnalité sur plusieurs sites sans avoir besoin d'un jeton pour chaque origine.

En savoir plus : Qu'est-ce que les tests d'origine tierce ?

Essais avant abandon

Toutes les phases d'évaluation de l'origine ne sont pas destinées à tester de nouvelles API. Certains tests permettent de réactiver temporairement une fonctionnalité obsolète. Il s'agit des tests de dépréciation, et dans certains contextes, on les appelle des tests d'origine "inverses".

Par exemple, à partir de Chrome 85, le cache des applications n'est plus disponible par défaut dans Chrome. Les sites qui ont besoin de plus de temps pour migrer d'AppCache peuvent s'inscrire à l'évaluation avant arrêt pour continuer à utiliser AppCache jusqu'à Chrome 93.

Participer à une phase d'évaluation

  1. Choisissez une phase d'évaluation dans la liste des essais actifs.
  2. Demandez un jeton en cliquant sur le bouton Register (Enregistrer) et en remplissant le formulaire.
  3. Indiquez le jeton sur chaque page Web pour laquelle vous souhaitez activer la fonctionnalité d'essai :
  4. Essayez la nouvelle fonctionnalité.
  5. Envoyer des commentaires. Pour ce faire, accédez au site d'essai d'origine. Ces commentaires ne sont pas publics et ne sont disponibles que pour un nombre limité de membres de l'équipe Chrome. Chaque test fournit également un lien permettant d'envoyer des commentaires spontanés à la communauté. Il s'agit généralement d'un lien vers la fonctionnalité sur GitHub ou sur un autre canal public.
  6. Lorsque votre jeton expire, vous recevez un e-mail contenant un lien de renouvellement. Pour ce faire, vous êtes à nouveau invité à envoyer des commentaires.

Vous pouvez vous inscrire plusieurs fois à la même phase d'évaluation pour des origines différentes et inclure plusieurs jetons sur la même page. Cela peut être utile si vous devez fournir des jetons valides pour les ressources diffusées à partir de différentes origines, telles que le code inclus sur plusieurs sites que vous possédez.

Le framework de test d'origine recherche le premier jeton valide, puis ignore tous les autres jetons. Pour ce faire, utilisez les Outils pour les développeurs Chrome.

Fournir un jeton par programmation

Au lieu de fournir un jeton en tant qu'en-tête HTTP ou en tant que balise Meta dans le code HTML de votre page, comme décrit précédemment, vous pouvez injecter un jeton avec JavaScript:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Utilisez cette méthode si vous participez à un essai tiers.

Jetons et iFrames

Pour accéder à une fonctionnalité d'essai à partir d'une iframe, vous pouvez fournir un jeton d'essai dans une balise méta, un en-tête HTTP ou de manière programmatique.

Comme pour toute utilisation de jeton, l'origine enregistrée pour le jeton doit correspondre au contexte JavaScript qui accède à la fonctionnalité d'essai: soit l'origine de la page qui inclut un script intégré, soit le src d'un élément <script> pour JavaScript inclus à partir d'un fichier externe.

Jetons et extensions

Pour utiliser une fonctionnalité d'essai dans un script en arrière-plan, un pop-up, un panneau latéral ou un document hors écran, utilisez la clé trial_tokens dans votre fichier manifest.json.

"trial_tokens": ["AnlT7gRo/750gGKtoI/A3D2rL5yAQA9wISlLqHGE6vJQinPfk0HiIij5LhWs+iuB7mTeotXmEXkvdpOAC1YjAgAAAG97Im9yaWdpbiI6ImNocm9tZS1leHRlbnNpb246Ly9sampoamFha21uY2lib25uanBhb2dsYmhjamVvbGhrayIsImZlYXR1cmUiOiJJQ2Fubm90QmVsaWV2ZVlvdVdhc3RlZFlvdXJUaW1lRGVjb2RpbmdUaGlzIiwiZXhwaXJ5Ijo1NzI1NDA3OTk5fQ=="]

Les scripts de contenu sont gérés différemment. Exposer une fonctionnalité à un seul monde peut être déroutant et peu intuitif. Au lieu d'utiliser le trial_token du fichier manifeste, ajoutez le jeton à la page en insérant un en-tête à l'aide de declarativeNetRequest ou par programmation directement dans votre script de contenu. N'oubliez pas que les jetons sont associés à des domaines spécifiques. Vous devez donc en enregistrer un pour le domaine sur lequel le script de contenu s'exécute, et non pour votre ID d'extension.

Pour enregistrer votre extension pour un essai, utilisez l'URL chrome-extension://YOUR_EXTENSION_ID, par exemple chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk.

Renouveler l'inscription à l'essai d'origine

Si un essai d'origine est prolongé, vous recevrez un e-mail vous avertissant que vous devez renouveler l'enregistrement et fournir un nouveau jeton pour chaque origine inscrite à l'essai.

  1. Accédez à la page Mes inscriptions.

  2. Pour chaque origine enregistrée pour l'essai prolongé, cliquez sur le bouton RENEW (RENONVELER). Capture d&#39;écran de la page &quot;Mes enregistrements&quot; de la version d&#39;essai de Chrome pour les origines, montrant les boutons RENOUVELER

  3. Copiez le nouveau jeton et mettez-le à la disposition de chaque page qui doit rester inscrite au test. Vous pouvez fournir plusieurs jetons si nécessaire : Chrome ignore les jetons non valides ou expirés.

Afficher les informations sur l'essai d'origine

Consultez les informations sur les phases d'évaluation d'origine disponibles pour une page dans le panneau Application de Chrome DevTools.

Informations sur la phase d&#39;évaluation d&#39;origine d&#39;un site affichées dans la vue d&#39;informations sur le frame du panneau &quot;Application&quot; de Chrome DevTools.

Vous pouvez également utiliser notre décodeur de jeton de test d'origine pour afficher les données encodées dans un jeton.

Outil de décodage des phases d&#39;évaluation, affichant les valeurs décodées des phases d&#39;évaluation.

Démonstrations de la phase d'évaluation

En savoir plus