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 afin que vous puissiez la tester et l'offrir à vos utilisateurs pendant une durée limitée. Une fois le test terminé et les commentaires évalués, Chrome décide si la fonctionnalité doit être disponible pour tous les utilisateurs.

Vous pouvez vous inscrire à un essai en version d'origine pour activer une fonctionnalité pour tous les utilisateurs de votre origine, sans qu'ils aient à activer des indicateurs ni à passer à une autre version de Chrome (bien qu'ils puissent avoir besoin de mettre à niveau). Une fois enregistrés, les développeurs peuvent créer des démonstrations et des prototypes à l'aide des 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.

Disponibilité

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, est probablement limitée aux spécifications et explications de l'API. Nous essayons de vous 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

Par défaut, une fonctionnalité de test d'origine n'est disponible que sur l'origine enregistrée pour le test. Certains essais proposent une option de mise en correspondance tierce lors de l'enregistrement. Cela permet aux fournisseurs de contenus ou de services intégrés d'essayer une nouvelle fonctionnalité sur plusieurs sites, sans avoir besoin d'un jeton pour chaque origine.

En savoir plus: Qu'est-ce qu'un test d'origine tierce ?

Essais avant abandon

Certains essais Origin Trial vous permettent de réactiver temporairement une fonctionnalité obsolète. Il s'agit des tests de dépréciation. Dans certains contextes, on les appelle "tests d'origine inversés".

Par exemple, les événements de mutation ont été supprimés à partir de Chrome 127. Les sites qui ont besoin de plus de temps avant de supprimer ces événements peuvent s'inscrire à l'évaluation avant arrêt pour réactiver temporairement les événements sur des sites spécifiés.

Participer à un test de l'origine

  1. Choisissez un test d'origine dans la liste des tests 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 reprises au même essai d'origine, pour différentes origines, 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. Vous pouvez le vérifier avec les outils pour les développeurs Chrome.

Fournir un jeton de manière programmatique

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 de l'une des manières suivantes:

N'oubliez pas que les jetons sont associés à des domaines spécifiques. Vous devez donc vous enregistrer 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 à Mes inscriptions.
  2. Pour chaque origine enregistrée pour l'essai prolongé, cliquez sur RENEW (RENONVELER). Exemple de page &quot;Mes enregistrements&quot;, avec les boutons &quot;RENEW&quot; (RENONVELER)
  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 un site dans le panneau Application de Chrome DevTools.

Vue des détails du frame du panneau &quot;Application&quot; des outils pour les développeurs Chrome.

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échiffrement des essais d&#39;origine, affichant les valeurs décodées des essais d&#39;origine.

Démonstrations

Les sites suivants présentent des exemples de déploiement de jetons.

Fournir un jeton d'essai d'origine

Outils de l'essai Origin Trial

Fonctionnalités de l'essai Origin Trial

Vous trouverez ci-dessous des démonstrations d'API en cours d'évaluation.

Ressources

Poursuivez votre lecture de la documentation sur les concepts Chrome:

En savoir plus sur les phases d'évaluation d'origine dans Chrome:

Autres navigateurs

Rechercher des essais d'origine dans d'autres navigateurs: