Playwright-Testautomatisierung

Playwright-Automatisierungen als Automatisierungstyp in Test Manager neben in Studio erstellten Automatisierungen, ohne vorhandene Testsuiten in Studio neu schreiben zu müssen.

Hinweis:

Diese Funktion ist kontrolliert verfügbar und wird nur für berechtigte Mandanten bereitgestellt. Es ist in Test Manager nur verfügbar, wenn dieser über Test Cloud bereitgestellt wird, und UiPath muss es für Ihren Mandanten aktivieren, bevor es funktioniert. Wenden Sie sich mit den Details zu Ihrem Mandanten an Ihr UiPath-Accountteam, um die Aktivierung anzufordern.

Test Manager kann Testfälle ausführen, die auf Playwright-Automatisierungen basieren, zusätzlich zu in Studio erstellten (Robot-)Automatisierungen. Teams, die bereits End-to-End-Tests in Playwright schreiben, können diese Tests für Orchestrierung, Planung, Berichterstattung und Rückverfolgbarkeit in Test Manager übernehmen, ohne sie in Studio neu schreiben zu müssen.

Voraussetzungen

Bevor eine Playwright-Automatisierung über den Test Manager ausgeführt werden kann, muss das für die Ausführung verwendete Roboterkonto (z. B. ein Unattended Robot-Konto, das für serverlose Tests konfiguriert ist) dem Test Manager-Projekt in den Projekteinstellungen mit der Rolle Test Executor hinzugefügt werden. Die Mitgliedschaft in der Gruppe „Automation Users“ gewährt dies nicht. Ohne die Rolle Test Executor werden Tests weiterhin ausgeführt und abgeschlossen, aber die Ergebnisse erreichen den Test Manager nie, da jede Testfallausführung mit einem Ergebnis von None und einem Protokolleintrag enden würde:

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."
}

Wie Playwright-Automatisierungen durchgängig (End-to-End) funktionieren

Ein Playwright-Testprojekt befindet sich in einem eigenen Source-Control-System außerhalb von UiPath. Von dort aus gelangt die Automatisierung über den folgenden Ablauf zu Test Manager:

1. Das Projekt wird mithilfe des tm pack-Befehls der UiPath-Befehlszeilenschnittstelle (CLI) als UiPath-Automatisierungspaket paketiert und anschließend im globalen mandantenweiten Paketfeed von Orchestrator oder in einem dedizierten Feed auf Ordnerebene veröffentlicht. Die Schritte zur Paketierung finden Sie unter Paketieren von Playwright-Projekten für Test Manager.
2. Das veröffentlichte Paket kann in Test Manager genauso ausgewählt werden wie eine in Studio veröffentlichte Automatisierung, und zwar über den Ablauf „Auswählen der Automatisierung“.
3. Wenn das Paket mit einem Test Manager-Projektschlüssel erstellt wurde, werden passende Testfälle automatisch erstellt und die Playwright-Automatisierung automatisch mit jedem Testfall verknüpft, sobald Test Manager das Paket erfasst. Andernfalls wird der Testfall separat erstellt und die Automatisierung manuell verknüpft, wobei derselbe Ablauf wie für Studio-Automatisierungen verwendet wird.
4. Ab diesem Zeitpunkt verhält sich der Testfall wie jeder andere automatisierte Testfall in Test Manager: Er kann Testsätzen hinzugefügt, bei Bedarf oder nach einem Zeitplan ausgelöst werden, und seine Ergebnisse, Artefakte und Rückverfolgbarkeitslinks werden wie bei allen anderen Testfällen angezeigt.

Was Test Manager aus Ihrem Playwright-Projekt erfasst

Test Manager-Feld	Kommt von Playwright
Name und Beschreibung	Nur Testtitel. Die Paketmetadaten enthalten kein Beschreibungsfeld, sodass „Beschreibung“ nicht ausgefüllt wird.
Beschriftungen	@tag / Anmerkungswerte (z. B. resilience, observability), die als Bezeichnungen in den Testfall kopiert werden, um die Filterung und die Eingrenzung auf Testsätze zu ermöglichen.
Projekt-/Spezifikationsdatei	Das Playwright-Projekt (aus playwright.config.ts) und die Spezifikationsdatei, zu der der Test gehört, werden als Metadaten erfasst. Pro Test wird ein Testfall erstellt – es gibt keine Aufteilung nach Projekten.
Quelle (Registerkarte „Automatisierung auswählen“)	Ein Quellenwert von „Playwright“ oder „UiPath“, der in der Auswahl „Automatisierung auswählen“ angezeigt wird.

Hinweis:

Name und Beschreibung, Bezeichnungen und Projekt-/Spezifikationsdatei werden im Testfall als automatisch generierte Systembezeichnungen umgesetzt. Nur „Quelle“ ist ein separates Feld, das in der Auswahl „Automatisierung auswählen“ als eigene Spalte und nicht als Bezeichnung angezeigt wird.

Terminologie

• Automatisierung und Testfall bleiben in Test Manager unterschiedliche Artefakttypen.
• Eine Automatisierung, ob Playwright oder Studio, wird einem Testfall zugewiesen.
• Ein Playwright-Test wird nie selbst als Testfall bezeichnet.

Parität bei Ausführung und Berichterstattung

Nach der Zuweisung wird ein auf einer Playwright-Automatisierung basierender Testfall genau wie ein in Studio erstellter Testfall ausgeführt, geplant und ausgewertet: dieselben Trigger, dieselben Regeln für die Zugehörigkeit zu Testsätzen, dieselben Ergebnis- und Rückverfolgbarkeitsansichten.

Bekannte Einschränkungen

Einschränkung	Was es bedeutet
Nur Chromium	Der Ausführungs-Pod installiert nur Chromium. Ein für die Verwendung von Firefox oder WebKit konfiguriertes Projekt kann weiterhin ausgewählt werden, aber die Ausführung erfolgt nicht in diesem Browser.
Nur serverlose Ausführung	Playwright-Tests werden nur in der serverlosen UiPath-Infrastruktur mit einem dedizierten Pod pro Ausführung ausgeführt. Die On-Premises- oder lokale Roboterausführung wird noch nicht unterstützt.
Nur Node.js (JavaScript/TypeScript)	Nur auf Node.js basierende Playwright-Projekte werden unterstützt. playwright-python, playwright-java und playwright-dotnet-Projekte werden nicht unterstützt.
In sich geschlossenes Projekt erforderlich	Jedes Projekt muss aus einem in sich geschlossenen Verzeichnis paketiert werden, wobei Abhängigkeiten im paketierten Stammverzeichnis aufgelöst werden können. Ein Mono-Repo-Unterordner funktioniert nur, wenn er in sich geschlossen ist.
Keine Details auf Assertion-Ebene	Test Manager stellt die einzelnen Playwright-Assertions nicht separat bereit. Stattdessen greift Test Manager auf das eigene „Bestanden/Fehlgeschlagen“-Ergebnis von Playwright pro Versuch und die konfigurierten Anhänge zurück.
Kein Import von Ergebnissen aus externen Ausführungen	Ergebnisse einer Playwright-Suite, die außerhalb von Test Manager ausgeführt wird, z. B. in der eigenen CI-Umgebung eines Kunden, können nicht importiert werden.
Ein Auftrag pro Ausführung	Alle Testfälle in einer Playwright-Testsatzausführung werden in einem einzigen Orchestrator-Auftrag ausgeführt – bei einem überdimensionierten Testsatz besteht das Risiko eines Job-Timeouts.
Ausführungszeitlimit	Eine Playwright-Testsatzausführung hat ein Zeitlimit von 45 Minuten, unabhängig von den Zeitlimits für Videoaufzeichnung, die an anderer Stelle in Test Manager gelten.
Kein Multi-Pod-Sharding	Die gesamte Suite wird pro Ausführung in einem Pod ausgeführt. Die Worker-Parallelität von Playwright wird entsprechend der Konfiguration angewendet, aber verteiltes Sharding über mehrere Pods hinweg ist noch nicht verfügbar.
Keine Berichterstattung pro Fixture	Playwright-Fixtures (test.extend()) werden normal ausgeführt, aber Test Manager bildet sie weder auf Testfallebene noch pro Fixture in der Berichterstattung ab.
Keine Selbstreparatur	Die agentenbasierte Selbstreparatur ist für Playwright-Automatisierungen noch nicht verfügbar.
Keine erzwungene Ausführungsreihenfolge	Die Testfallreihenfolge folgt playwright.config.ts. Wenn Sie „Ausführungsreihenfolge erzwingen“, „RPA-Aktivitätsabdeckung“ oder „Healing Agent“ in einem Playwright-Testsatz aktivieren, schlägt die Auführung sofort fehl.
Paket- oder versionsübergreifendes Mischen nicht zulässig	Das Mischen von Testfällen aus zwei verschiedenen Playwright-Paketen oder aus zwei Versionen desselben Pakets in einem Testsatz ist blockiert.
Datengesteuerte Testsätze führen jede Variation aus	Jede Variante eines parametrisierten Playwright-Tests ist ein eigener Testfall. Wenn Sie eine Variation ausführen, wird jede Variation auf dieser Zeile ausgeführt.
Keine UiPath-Videoaufzeichnung oder kein Live-Streaming	Die Aktivierung der Videoaufzeichnung in einem Playwright-Testsatz hat keine Auswirkung, und die Registerkarte „Aufzeichnen“ sowie die Live-Stream-Aktion zeigen keine Daten an. Die eigene Videoerfassung von Playwright (use: { video } in playwright.config.ts) ist nicht betroffen – diese .webm-Dateien werden weiterhin als Artefakte angehängt.

Testfälle, die als unabhängige test() -Aufrufe definiert sind, jeder auf einer eigenen Zeile, werden unabhängig ausgeführt. Der Trace Viewer zeigt das eigene Ergebnis jeder Variation an, und Ausführungsprotokolle zeigen jede Variation als ausgeführt an.

Lizenzierung

Die Ausführung eines Playwright-Tests über Test Manager verbraucht auf der Ebene der zugrunde liegenden Roboterausführung dieselbe Plattformkapazität wie jede andere serverlose Testausführung – für Playwright gilt keine andere Verbrauchsrate als für native UiPath-Testautomatisierungen. Weitere Informationen finden Sie unter Unified Pricing: Lizenzierung von Test Manager.

Zugehörig

• Funktionsweise der Playwright-Artefakterfassung
• Packen von Playwright-Projekten für Test Manager
• Konfigurieren der Artefakterfassung für Playwright-Tests
• Auswählen von Automatisierungen