Automatisation de test Playwright

Automatisations Playwright en tant que type d'automatisation de Test Manager aux côtés des automatisations créées par Studio, sans réécrire les suites de test existantes dans Studio.

Remarque :

Cette fonctionnalité est disponible dans Test Manager uniquement lorsqu'il est fourni via Test Cloud.

Test Manager peut exécuter des cas de test pris en charge par les automatisations de Playwright, en plus des automatisations créées par Studio (Robot). Les équipes qui écrivent déjà des tests de bout en bout dans Playwright peuvent intégrer ces tests dans Test Manager pour l'orchestration, la planification, la création de rapports et la traçabilité, sans les réécrire dans Studio.

Prérequis

Avant qu’une automatisation Playwright puisse s’exécuter à partir de Test Manager, le compte Robot utilisé pour l’exécution (par exemple, un compte Robot Unattended configuré pour les tests sans serveur) doit être ajouté au projet Test Manager dans Paramètres du projet, avec le rôle Exécuteur de test . L'appartenance au groupe Automation Users seul ne l'accorde pas. Sans le rôle d'exécuteur de test, les tests sont toujours exécutés et terminés, mais les résultats n'atteignent jamais Test Manager, car l'exécution de chaque cas de test se termine par le résultat de None et une entrée de journal:

Playwright test execution faulted before results could be uploaded.

{
  "Code": "Serverless.PlaywrightTest.ResultUploadFailed",
  "Title": "Failed to upload Playwright results to Test Manager",
  "Detail": "The tests ran but an artifact upload URL could not be obtained from Test Manager, so the results were never uploaded. Check that Test Manager is reachable from the pod and the execution context is complete. The execution will be reconciled, but per-test results may be missing."
}

Lecture des automatisations Playwright de bout en bout

Un projet de test Playwright se trouve dans son propre système de contrôle de code source, en dehors d'UiPath. À partir de là, l'automatisation atteint Test Manager via le flux suivant :

1. Le projet est regroupé dans un package d'automatisation UiPath à l'aide de la commande tm pack de l'interface de ligne de commande (CLI) UiPath, puis publié dans le flux de packages global à l'échelle du locataire d'Orchestrator ou un flux dédié au niveau du dossier. Pour les étapes de packaging, consultez la section Packaging des projets Playwright pour Test Manager.
2. Le package publié devient sélectionnable dans Test Manager de la même manière qu'une automatisation publiée par Studio, via le flux Sélectionner l'automatisation.
3. Si le package a été créé avec une clé de projet Test Manager, les cas de test correspondants sont automatiquement créés et l'automatisation Playwright est automatiquement liée à chacun d'eux une fois que Test Manager ingère le package. Sinon, le cas de test est créé séparément et l'automatisation est liée manuellement, à l'aide du même flux utilisé pour les automatisations de Studio.
4. À partir de ce point, le cas de test se comporte comme n'importe quel autre cas de test automatisé dans Test Manager : il peut être placé dans des ensembles de tests, déclenché à la demande ou sur une planification et ses résultats, ses artefacts et ses liens de traçabilité apparaissent aux côtés de tous les autres cas de test.

Ce que Test Manager capture à partir de votre projet Playwright

Champ Test Manager	Provient de Playwright
Nom et description	Titre de test uniquement. Les métadonnées du package ne portent aucun champ de description, la description n'est donc pas remplie.
Libellés	@tag / valeurs d'annotation (par exemple, resilience, observability), copiées dans le cas de test en tant que libellés pour le filtrage et l'étendue de l'ensemble de tests.
Fichier de projet / de spécifications	Le projet Playwright (à partir de playwright.config.ts) et le fichier de spécifications auquel appartient le test, capturés sous forme de métadonnées. Un cas de test est créé par test - il n'y a aucune distribution par projet.
Source (onglet Sélectionner l'automatisation)	Une valeur source de Playwright ou UiPath, affichée dans le sélecteur Sélectionner l'automatisation.

Remarque :

Nom et description, les libellés et le fichier de projet/spécifications sont tous implémentés en tant que libellés système générés automatiquement sur le cas de test. Seule la Source est un champ distinct, affiché comme sa propre colonne dans le sélecteur Sélectionner l'automatisation plutôt que comme un libellé.

Pour les champs et les libellés système que Test Manager renseigne sur un cas de test lié à une automatisation Playwright, voir Champs du cas de test Playwright.

Test Manager - Terminologie Playwright

• L'automatisation et le cas de test restent des types d'artefacts distincts dans Test Manager.
• Une automatisation, qu'elle soit Playwright ou Studio, est affectée à un cas de test.
• Un test Playwright n'est jamais lui-même appelé un cas de test.

Parité de l'exécution et de la création de rapports

Une fois affecté, un cas de test soutenu par Playwright est exécuté, planifié et rapporté exactement comme un cas créé par Studio : mêmes déclencheurs, mêmes règles d'adhésion à l'ensemble de tests, mêmes résultats et vues de traçabilité.

Limites connues

Limitation	Ce que cela signifie
Chromium uniquement	Le pod d'exécution installe uniquement Chromium. Un projet configuré pour utiliser Firefox ou WebKit peut toujours être sélectionné, mais l'exécution ne se fait pas sur ce navigateur.
Exécution sans serveur uniquement	Les tests Playwright s'exécutent uniquement sur l'infrastructure UiPath sans serveur, avec un pod dédié par exécution. L'exécution du robot sur site ou locale n'est pas encore prise en charge.
Node.js (JavaScript/TypeScript) uniquement	Uniquement basé sur Node.js Les projets Playwright sont pris en charge. playwright-python, playwright-java, et les projets playwright-dotnet ne sont pas pris en charge.
Projet autonome requis	Chaque projet doit être compressé à partir d'un répertoire autonome, avec des dépendances résolubles à la racine compressée. Un sous-dossier de mono-repo ne fonctionne que s'il est autonome.
Aucun détail au niveau de l'assertion	Test Manager n'expose pas les assertions de Playwright individuellement. Il s'appuie sur le résultat de réussite/échec par tentative de Playwright et les pièces jointes configurées.
Aucune importation de résultats exécutés en externe	Les résultats d'une suite Playwright s'exécutant en dehors de Test Manager, par exemple dans la CI d'un client, ne peuvent pas être importés.
Tâche unique par exécution	Tous les cas de test d'une exécution d'ensemble de tests Playwright s'exécutent dans une seule tâche Orchestrator - un ensemble de tests surdimensionné risque d'entraîner un dépassement du délai d'exécution de la tâche.
Limite de temps d'exécution	Une exécution d'ensemble de tests Playwright a une limite de temps de 45 minutes, distincte des limites de temps d'enregistrement vidéo qui s'appliquent ailleurs dans Test Manager.
Aucune fragmentation multi-pods	L'ensemble de la suite s'exécute dans un pod par exécution. Le parallélisme de travail propre à Playwright s'applique tel que configuré, mais le partitionnement distribué entre les pods n'est pas encore disponible.
Aucun rapport par fixture	Les fixtures Playwright (test.extend()) s'exécutent normalement, mais Test Manager ne les modélise pas avec une création de rapports au niveau du cas de test ou par fixture.
Aucune auto-réparation	L'auto-réparation agentique n'est pas encore disponible pour les automatisations de Playwright.
Aucun ordre d'exécution appliqué	L'ordre du cas de test suit playwright.config.ts. L'activation de l'application de l'ordre d'exécution, de la couverture de l'activité RPA ou de Healing Agent sur un ensemble de tests Playwright entraîne l'échec rapide de l'exécution.
Mélange de packages ou de versions croisées interdit	Le mélange de cas de test de deux packages Playwright différents, ou du même package dans deux versions différentes, dans un ensemble de tests est bloqué.
Les ensembles de tests basés sur les données exécutent chaque variation	Chaque variation d'un test Playwright paramétré est son propre cas de test. L'exécution d'une variation exécute chaque variation sur cette ligne.
Aucun enregistrement vidéo UiPath ou diffusion en direct	L'activation de l'enregistrement vidéo sur un ensemble de tests Playwright n'a aucun effet et l'onglet Enregistrement et l'action de diffusion en direct n'affichent aucune donnée. La capture vidéo de Playwright (use: { video } dans playwright.config.ts) n'est pas affectée - ces fichiers .webm sont toujours joints en tant qu'artefacts.

Les cas de test définis comme des appels test() indépendants, chacun sur sa propre ligne, s'exécutent indépendamment. La visionneuse de traçage affiche le résultat propre de chaque variation et les journaux d'exécution indiquent chaque variation comme ayant été exécutée.

Licences

L'exécution d'un test Playwright via Test Manager consomme la même capacité de la plateforme que toute autre exécution de test sans serveur, au niveau sous-jacent de l'exécution du robot - il n'y a pas de taux d'utilisation différent pour Playwright par rapport aux automatisations de test UiPath natives. Pour plus de détails, voir Consommables.

Articles associés

• Comment fonctionne la capture des artefacts Playwright
• Packaging de projets Playwright pour Test Manager
• Configuration de la capture d'artefacts pour les tests Playwright
• Sélectionner l'automatisation
• Champs du cas de test Playwright