Premiers pas avec les phases d'évaluation

Testez une fonctionnalité nouvelle ou expérimentale d'une plate-forme Web.

Sam Dutton

Les phases d'évaluation vous permettent d'accéder à une fonctionnalité nouvelle ou expérimentale afin de créer une fonctionnalité que vos utilisateurs peuvent tester pendant une durée limitée avant qu'elle ne soit mise à la disposition de tous.

Lorsque Chrome propose une phase d'évaluation pour une fonctionnalité, vous pouvez vous inscrire pour l'activer pour tous les utilisateurs de votre origine, sans qu'ils aient à activer/désactiver les options ou à passer à une autre version de Chrome (bien qu'une mise à niveau soit nécessaire). Les phases d'évaluation 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 disposés et capables de travailler de manière relativement indépendante en utilisant la documentation disponible. Celle-ci, à ce stade, se limitera probablement aux spécifications et aux explications de l'API, bien que nous tentions de fournir des conseils dans la mesure du possible.

Si vous vous inscrivez à un essai, l'équipe Chrome vous demandera régulièrement de lui communiquer vos commentaires sur votre utilisation de la fonctionnalité d'essai. Certaines fonctionnalités peuvent faire l'objet de plusieurs phases d'évaluation au fur et à mesure que les commentaires sont intégrés et que les ajustements sont effectués.

Les phases d'évaluation sont également disponibles pour Firefox et Microsoft Edge.

Phases d'évaluation tierces

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 phases d'évaluation tierces permettent aux fournisseurs de contenu intégré d'essayer une nouvelle fonctionnalité sur plusieurs sites sans nécessiter de jeton pour chaque origine.

Pour en savoir plus, consultez En quoi consistent les phases d'évaluation tierce ?

Essais d'abandon

Les phases d'évaluation ne sont pas toutes conçues pour tester de nouvelles API. Certains essais permettent de réactiver temporairement une fonctionnalité obsolète. C'est ce que l'on appelle des essais d'abandon et, dans certains contextes, des "phases d'évaluation inverses".

Par exemple, AppCache à partir de Chrome 85 n'est plus disponible dans Chrome par défaut. Les sites ayant besoin de plus de temps pour quitter 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 (S'inscrire) et en remplissant le formulaire.
  3. Fournissez le jeton sur chaque page Web sur laquelle vous souhaitez activer la fonctionnalité d'essai :
    • En tant que balise Meta dans la section <head>: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
    • En tant qu'en-tête HTTP: Origin-Trial: TOKEN_GOES_HERE
    • En fournissant un jeton par programmation.
  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 accessibles qu'à un nombre limité de membres de l'équipe Chrome. Pour chaque essai, vous trouverez également un lien permettant aux membres spontanés de donner leur avis. Cela renvoie généralement à la fonctionnalité disponible sur GitHub ou sur un autre canal public.
  6. À l'expiration de votre jeton, vous recevrez 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, telles que du code inclus sur plusieurs sites dont vous êtes le propriétaire.

Le framework des essais d'origine recherche le premier jeton valide, puis ignore tous les autres. Pour le vérifier, utilisez les outils pour les développeurs Chrome.

Fournir un jeton par programmation

Au lieu de fournir un jeton sous forme d'en-tête HTTP ou de 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-la si vous participez à un essai tiers.

Jetons et iFrames

Pour accéder à une fonctionnalité test à partir d'un iFrame, vous pouvez fournir un jeton d'essai dans une balise Meta, un en-tête HTTP ou par programmation.

Comme pour toutes les utilisations de jetons, 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 d'arrière-plan, un pop-up ou un document hors écran, ajoutez un trial_token à votre fichier manifeste.json.

Les scripts de contenu sont gérés différemment. L'exposition d'une fonctionnalité à un monde donné peut être déroutante et peu intuitive. Au lieu d'utiliser la propriété trial_token du fichier manifeste, ajoutez le jeton à la page en insérant un en-tête à l'aide de declaritiveNetRequest ou par programmation directement dans votre script de contenu. N'oubliez pas que les jetons sont liés à des domaines spécifiques. Vous devez donc en enregistrer un pour le domaine sur lequel le script de contenu est exécuté, plutôt que pour votre ID d'extension.

Pour enregistrer votre extension en vue d'un essai, utilisez l'URL chrome-extension://YOUR_EXTENSION_ID (par exemple, chrome-extension://ljjhjaakmncibonnjpaoglbhcjeolhkk).

Renouveler l'inscription à la phase d'évaluation

Si une phase d'évaluation est prolongée, vous recevrez un avertissement par e-mail vous informant 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 point de départ enregistré pour la période d'essai prolongée, cliquez sur le bouton RENOUVELER. Capture d&#39;écran de la page &quot;Mes inscriptions&quot; de la phase d&#39;évaluation de Chrome, avec les boutons RENOUVELER

  3. Copiez le nouveau jeton et rendez-le disponible pour chaque page qui doit rester inscrite à l'essai. Vous pouvez fournir plusieurs jetons si nécessaire. Chrome ignore les jetons non valides ou arrivés à expiration.

Afficher les informations sur la phase d'évaluation

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

Informations sur la phase d&#39;évaluation pour un site affichés 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 d'évaluation d'origine pour afficher les données encodées dans un jeton.

Outil de décodeur de la phase d&#39;évaluation, affichant les valeurs décodées de la phase d&#39;évaluation.

Démonstrations de la phase d'évaluation

En savoir plus