Partager via

Utiliser les essais d’origine dans Microsoft Edge

  • Article

Utilisez les essais d’origine pour tester des API expérimentales sur votre propre site en direct pendant une période limitée. Lors de l’utilisation des essais d’origine, les utilisateurs de Microsoft Edge qui visitent votre site peuvent exécuter du code qui utilise des API expérimentales.

Pour afficher la liste des essais d’origine disponibles et inscrire votre origine afin d’essayer l’un des essais d’origine, consultez Microsoft Edge Origin Trials. Pour évaluer la pertinence de l’utilisation des API expérimentales sur votre site web, case activée la configuration minimale requise pour Microsoft Edge et case activée la date d’expiration de la version d’évaluation.

Vous pouvez fournir des commentaires aux ingénieurs des fonctionnalités du navigateur et à la communauté des normes web sur la conception de l’API de la fonctionnalité, vos cas d’usage ou votre expérience avec l’API de la fonctionnalité, à l’aide de l’onglet Problèmes dans le dépôt de la fonctionnalité du navigateur.

Fonctionnement du jeton d’essai d’origine

Le mécanisme origin-trials permet à un utilisateur de votre page web d’utiliser l’API de fonctionnalité expérimentale de la version d’évaluation d’origine dans son navigateur Microsoft Edge, malgré l’état désactivé par défaut de la fonctionnalité. Le navigateur Microsoft Edge de l’utilisateur détecte le jeton de l’essai d’origine, puis active automatiquement l’indicateur de fonctionnalité du navigateur qui correspond à la version d’évaluation d’origine pour laquelle le jeton est valide. L’utilisateur n’a pas besoin d’en définir edge://flags dans Microsoft Edge.

Pour prendre en charge l’utilisation des API expérimentales d’un essai d’origine dans votre site web :

  1. Inscrivez le domaine d’origine sur lequel vous souhaitez utiliser la fonctionnalité expérimentale (par exemple, https://example.com), puis un jeton d’essai d’origine est généré pour vous.

  2. Copiez le jeton sur votre page web dans un <head>/<meta> élément ou dans un en-tête de réponse de Origin-Trial serveur HTTP.

  3. Lorsqu’un utilisateur Microsoft Edge visite votre page web et que le navigateur trouve un jeton origin-trial, le navigateur active la fonctionnalité origin-trial associée.

Inscription à un essai d’origine

Pour vous inscrire à un essai d’origine :

  1. Accédez à Microsoft Edge Origin Trials.

    Pour vous inscrire à la version d’évaluation d’origine de l’API Sélection d’annonces, consultez S’inscrire à l’API de sélection d’annonces.

  2. Sélectionnez une version d’évaluation active.

  3. Cliquez sur le bouton J’accepte les conditions d’utilisation .

  4. Si vous y êtes invité, connectez-vous. Par exemple, connectez-vous à GitHub, puis autorisez la page Microsoft Edge Origin Trials à utiliser la connexion au compte.

    Le formulaire Inscription de la nouvelle version d’évaluation d’origine s’ouvre :

    Formulaire d’inscription de la nouvelle version d’évaluation d’origine

  5. Dans la zone de texte Domaine , entrez une URL de domaine (telle que https://example.com) ou une URL de sous-domaine (telle que https://beta.example.com).

    Vous pouvez configurer le jeton d’essai d’origine pour prendre en charge l’un des éléments suivants :

    • Un seul domaine, tel que https://example.com, sans prendre en charge ses sous-domaines.
    • Un sous-domaine unique, tel que https://beta.example.com.
    • Un domaine, tel que https://example.com, et ses sous-domaines, tels que https://beta.example.com.

    Les chemins de fin et les paramètres de requête ne sont pas pris en charge. Si un URI est entré qui a un chemin de fin ou un paramètre de requête, tel que https://example.com/path/new-feature, le domaine racine (tel que https://example.com) ou le sous-domaine est inscrit, ignorant tout chemin de fin ou tout paramètre de requête.

  6. Définissez le bouton bascule Activer le jeton pour les sous-domaines ?

    • Pour activer l’utilisation de la version d’évaluation d’origine sur un domaine (tel que https://example.com) sans prendre en charge ses sous-domaines (par exemple https://beta.example.com), assurez-vous que le bouton bascule Activer le jeton pour les sous-domaines ? est désactivé.

    • Pour activer l’utilisation de la version d’évaluation d’origine uniquement sur un sous-domaine spécifique (par https://beta.example.comexemple), assurez-vous que le bouton bascule Activer le jeton pour les sous-domaines ? est désactivé.

    • Pour activer l’utilisation de la version d’évaluation d’origine sur un domaine (tel que https://example.com) et ses sous-domaines (tels que https://beta.example.com), activez le bouton bascule Activer le jeton pour les sous-domaines ? .

  7. Cliquez sur le bouton Envoyer .

    Un jeton d’essai d’origine est généré et s’affiche dans la section Inscriptions près du formulaire d’inscription de la nouvelle version d’évaluation d’origine :

    Jeton généré affiché dans la section Inscription

  8. Cliquez sur le bouton Copier , puis collez le jeton d’essai d’origine dans un emplacement sûr, en indiquant le domaine pour lequel il est destiné. Vous pouvez également afficher ces informations dans cette page web ultérieurement.

Utilisation du jeton d’essai d’origine sur votre site web

Utilisez le jeton sur votre site web de l’une des manières suivantes :

Option 1 : balise <meta> dans l’élément <head> d’une page web

Dans l’élément <head> d’une page web, incluez la balise suivante <meta> :

<meta http-equiv="origin-trial" content="EXAMPLE_TOKEN">

Remplacez EXAMPLE_TOKEN par votre jeton.

Option 2 : Un en-tête HTTP dans la réponse de votre serveur HTTP

Dans la réponse de votre serveur HTTP, ajoutez l’en-tête HTTP suivant :

Origin-Trial: EXAMPLE_TOKEN

Remplacez EXAMPLE_TOKEN par votre jeton.

Désactivation d’une expérience d’essai d’origine

Pour refuser une expérience (version d’évaluation d’origine) à laquelle vous êtes inscrit, supprimez le jeton d’essai d’origine de la <meta> balise ou des en-têtes de réponse du serveur.

Détection des fonctionnalités et secours approprié

Traiter les essais d’origine comme expérimentaux. Comme meilleure pratique, dans le code de votre site web, effectuez la détection des fonctionnalités et fournissez une solution de secours appropriée pour les cas suivants :

  • Si l’API de fonctionnalité expérimentale n’est pas disponible dans le navigateur de l’utilisateur.
  • Si le jeton origin-trial expire.
  • Si l’équipe des fonctionnalités Microsoft Edge met fin à la version d’évaluation de l’origine.

Consultez Implémentation de la détection des fonctionnalités sur MDN.

Test d’un essai d’origine à l’adresse localhost

Pour tester une fonctionnalité origin-trial sur localhost, accédez à edge://flags et activez l’indicateur de fonctionnalité approprié.

Le mécanisme qui détecte et utilise les jetons d’essai d’origine Microsoft Edge est pris en charge uniquement pour les domaines compatibles SSL, et non pour localhost.

Renouvellement d’un jeton d’essai d’origine

Les jetons d’essai d’origine expirent dans 6 semaines, par défaut. Lorsque le jeton d’essai d’origine expire, vous devez renouveler le jeton, ce qui signifie générer un nouveau jeton pour cet essai d’origine. Vous pouvez renouveler le jeton avant son expiration.

Pour renouveler un jeton d’essai d’origine :

  1. Accédez à Microsoft Edge Origin Trials.

    Pour l’essai d’origine de l’API sélection d’annonces, consultez S’inscrire à l’API de sélection d’annonces.

  2. Dans la section Mes essais inscrits , sélectionnez un essai d’origine.

  3. Dans la section Inscriptions , dans une ligne de jeton contenant un badge Expiré , cliquez sur le bouton Renouveler :

    Interface utilisateur pour renouveler un jeton

    Un nouveau jeton est généré et affiché.

  4. Dans la ligne qui contient le nouveau jeton, cliquez sur le bouton Copier , puis collez le nouveau jeton dans votre code.

Durée d’un essai d’origine

Un essai d’origine peut durer jusqu’à la date d’expiration prévue ou peut se terminer plus tôt.

Date d’expiration planifiée

Une fois que vous vous êtes inscrit à une version d’évaluation, votre jeton reste valide jusqu’à la date d’expiration de la version d’évaluation indiquée sur le carte d’information de l’essai d’origine. Après la date d’expiration de la version d’évaluation d’origine, le jeton ne fonctionnera plus et la fonctionnalité associée à la version d’évaluation d’origine sera considérée comme prête à être livrée, ou la fonctionnalité sera refusée pour un développement ultérieur.

Fin anticipée

Une équipe de fonctionnalités Microsoft Edge peut décider de mettre fin à une expérience plus tôt, avant la date d’expiration de l’essai. par exemple:

  • Si un incident de sécurité est provoqué par la fonctionnalité.
  • Si l’équipe des fonctionnalités a recueilli suffisamment de commentaires et a conclu que l’API actuellement proposée ne répond pas aux besoins des développeurs web, et qu’une modification majeure doit se produire.

Si une expérience se termine tôt, l’équipe de fonctionnalités propriétaire de la version d’évaluation d’origine envoie des e-mails à tous les développeurs qui sont inscrits à l’expérience.

Fournir des commentaires sur un essai d’origine

Veuillez fournir des commentaires sur la fonctionnalité expérimentale. L’onglet Problèmes du dépôt GitHub de la fonctionnalité permet au public de parler de la facilité d’utilisation et de la stabilité de la fonctionnalité.

Pour fournir des commentaires sur un essai d’origine :

  1. Accédez à Microsoft Edge Origin Trials.

  2. Sélectionnez une version d’évaluation active.

  3. Cliquez sur le bouton Commentaires . L’onglet Problèmes du dépôt GitHub du produit s’ouvre.

  4. Affichez les problèmes.

  5. Si un nouveau problème est nécessaire, cliquez sur le bouton Nouveau problème .

Pour l’essai d’origine de l’API sélection d’annonces, consultez Plutôt fournir des commentaires sur l’essai d’origine dans S’inscrire à l’API de sélection d’annonces.

Voir également

API de sélection d’annonces :

Externe: