Premiers pas avec les phases d'évaluation

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

Sam Dutton
Sam Dutton

Les phases d'évaluation vous permettent d'accéder à une fonctionnalité nouvelle ou expérimentale, qui permet à vos utilisateurs de les tester pendant une durée limitée avant de les rendre accessibles à tous.

Lorsque Chrome propose une phase d'évaluation pour une fonctionnalité, vous pouvez vous inscrire à la phase d'évaluation pour activer la 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 leur version). Les essais Origin Trial permettent aux développeurs de créer des démonstrations et des prototypes à l'aide de nouvelles fonctionnalités. Ces essais 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 phases d'évaluation sont publiques et ouvertes à 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 phases d'évaluation ne sont généralement disponibles que sur une base propriétaire: elles 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 ?

Évaluations avant arrêt

Les phases d'évaluation ne servent pas toutes à 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 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 de la phase d'évaluation. 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 des ressources diffusées à partir de différentes origines, comme du code inclus sur plusieurs sites dont vous êtes propriétaire.

Le framework des phases d'évaluation 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 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 de JavaScript qui accède à la fonctionnalité d'essai: soit l'origine de la page qui inclut un script intégré, soit l'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

Affichez des informations sur les phases d'évaluation disponibles pour une page dans le panneau Application des Outils pour les développeurs Chrome.

Informations sur la phase d&#39;évaluation pour un site affiché dans la vue détaillée du cadre du panneau **Application** 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 de l'essai Origin

En savoir plus