Partager via

Préversion des tests Microsoft Playwright

  • Article

Microsoft Playwright Testing est un service Azure entièrement géré qui utilise le cloud pour vous permettre d’exécuter des tests playwright avec une parallélisation beaucoup plus élevée entre différentes combinaisons de navigateurs de système d’exploitation simultanément. Cela signifie des exécutions de tests plus rapides avec une couverture de scénario plus large, ce qui permet d’accélérer la livraison des fonctionnalités sans sacrifier la qualité. Le service vous permet également de publier les résultats des tests et les artefacts associés sur le service et de les afficher dans le portail de service, ce qui facilite la résolution des problèmes. Avec le service Microsoft Playwright Testing, vous pouvez publier des fonctionnalités plus rapidement et plus en toute confiance.

Prêt à commencer ? Accédez à notre guide de démarrage rapide !

Démarrer

Suivez ces étapes pour exécuter votre suite de test Playwright existante avec le service.

Conditions préalables

  • Un compte Azure avec un abonnement actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
  • Votre compte Azure doit être affecté aupropriétaire , contributeurou à l’un des rôles d’administrateur classique .
  • azure CLI devez être installé sur la machine à partir de laquelle vous exécutez des tests playwright.

Créer un espace de travail

  1. Connectez-vous au portail Playwright avec votre compte Azure.

  2. Créez l’espace de travail.

    Créer un espace de travail

    Champ Description
    nom de l’espace de travail Nom unique pour identifier votre espace de travail.
    Le nom ne peut pas contenir de caractères spéciaux ni d’espaces blancs.
    abonnement Azure Sélectionnez un abonnement Azure dans lequel vous souhaitez créer l’espace de travail.
    région C’est là que les données d’exécution de test seront stockées pour votre espace de travail.

Si vous ne voyez pas cet écran, sélectionnez un espace de travail existant et accédez à la section suivante.

Installer le package Microsoft Playwright Testing

  1. Exécutez cette commande pour installer le package de service

    npm init @azure/microsoft-playwright-testing

L’installation du package de service crée un fichier de configuration de service nommé playwright.service.config.ts

La configuration du service sert à :

  • Direct and authenticate Playwright to the Microsoft Playwright Testing service.
  • Ajoutez des rapports microsoft Playwright Testing à votre configuration.
  • Remplacez les délais d’expiration pour les opérations de service, si nécessaire.

Vérifiez que votre projet utilise @playwright/test version 1.47 ou ultérieure.

Obtenir le point de terminaison de région

  1. Dans le portail Playwright, copiez la commande sous Ajouter un point de terminaison de région dans votre configuration.

    définir le point de terminaison de l’espace de travail

    L’URL du point de terminaison correspond à la région de l’espace de travail. Vous pouvez voir une URL de point de terminaison différente dans le portail Playwright, selon la région que vous avez sélectionnée lors de la création de l’espace de travail.

Configurer l’environnement

Vérifiez que le PLAYWRIGHT_SERVICE_URL que vous avez obtenu à l’étape précédente est disponible dans votre environnement.

Nous vous recommandons d’utiliser dotenv module pour gérer votre environnement. Avec dotenv vous utiliserez le fichier .env pour définir vos variables d’environnement.

N’oubliez pas d’ajouter .env fichier à votre fichier .gitignore afin de ne pas fuiter vos secrets.

npm i --save-dev dotenv

fichier .env

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/accounts/workspace-id/browsers

Configurer l’authentification

Pour exécuter vos tests playwright dans votre espace de travail Microsoft Playwright Testing, vous devez authentifier le client Playwright où vous exécutez les tests avec le service. Il peut s’agir de votre ordinateur de développement local ou de votre ordinateur CI.

Le service offre deux méthodes d’authentification : Microsoft Entra ID et Jetons d’accès.

Microsoft Entra ID utilise vos informations d’identification Azure, nécessitant une connexion à votre compte Azure pour un accès sécurisé. Vous pouvez également générer un jeton d’accès à partir de votre espace de travail Playwright et l’utiliser dans votre configuration.

Configurer l’authentification à l’aide de l’ID Microsoft Entra

L’ID Microsoft Entra est l’authentification par défaut et recommandée pour le service. À partir de votre machine de développement locale, vous pouvez utiliser Azure CLI pour vous connecter

az login

REMARQUE: si vous faites partie de plusieurs locataires Microsoft Entra, veillez à vous connecter au locataire auquel appartient votre espace de travail. Vous pouvez obtenir l’ID de locataire à partir du portail Azure, consultez Rechercher votre locataire Microsoft Entra. Une fois l’ID obtenu, connectez-vous à l’aide de la commande az login --tenant <TenantID>

Configurer l’authentification à l’aide de jetons d’accès

Vous pouvez générer un jeton d’accès à partir de votre espace de travail Playwright Testing et l’utiliser dans votre configuration. Toutefois, nous recommandons vivement l’ID Microsoft Entra pour l’authentification en raison de sa sécurité renforcée. Les jetons d’accès, tout en étant pratiques, fonctionnent comme des mots de passe de longue durée et sont plus susceptibles d’être compromis.

  1. Pour utiliser l’authentification basée sur les jetons d’accès, Activer l’authentification basée sur les jetons d’accès

  2. configurer l’authentification à l’aide de jetons d’accès

Nous vous recommandons vivement d’utiliser l’ID Microsoft Entra pour l’authentification auprès du service. Si vous utilisez des jetons d’accès, consultez Comment gérer les jetons d’accès

REMARQUE : Pour utiliser microsoft Playwright Testing dans les pipelines CI, vous devez configurer l’authentification avec le service à partir du pipeline, consultez configurer des tests de bout en bout continus sur différents navigateurs et systèmes d’exploitation

Exécuter les tests

Exécutez des tests playwright sur les navigateurs gérés par le service à l’aide de la configuration que vous avez créée ci-dessus.

npx playwright test --config=playwright.service.config.ts --workers=20

Étapes suivantes

Contribuant

Ce projet accueille les contributions et suggestions. La plupart des contributions vous obligent à accepter un contrat de licence contributeur (CLA) déclarant que vous avez le droit, et en fait, de nous accorder les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.opensource.microsoft.com.

Lorsque vous envoyez une demande de tirage, un bot CLA détermine automatiquement si vous devez fournir une claque et décorer la demande de tirage correctement (par exemple, vérification de l’état, commentaire). Suivez simplement les instructions fournies par le bot. Vous n’aurez besoin de le faire qu’une seule fois sur tous les dépôts à l’aide de notre CLA.

Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez le forum aux questions du Code de conduite ou contactez avec des questions ou commentaires supplémentaires.

Marques

Ce projet peut contenir des marques commerciales ou des logos pour des projets, produits ou services. L’utilisation autorisée de marques ou de logos Microsoft est soumise et doit suivre directives de marque de marque microsoft &. L’utilisation de marques ou de logos Microsoft dans les versions modifiées de ce projet ne doit pas provoquer de confusion ou impliquer le parrainage Microsoft. Toute utilisation de marques ou de logos tiers est soumise aux politiques de ces tiers.