Microsoft Playwright-Testvorschau

Microsoft Playwright Testing ist ein vollständig verwalteter Azure-Dienst, der die Cloud verwendet, um Playwright-Tests mit viel höherer Parallelisierung in verschiedenen Kombinationen von Betriebssystembrowsern gleichzeitig auszuführen. Dies bedeutet, dass schnellere Testläufe mit breiterer Szenarioabdeckung erfolgen, was dazu beiträgt, die Bereitstellung von Features zu beschleunigen, ohne dass die Qualität beeinträchtigt wird. Mit dem Dienst können Sie außerdem Testergebnisse und zugehörige Artefakte im Dienstportal veröffentlichen und diese im Dienstportal anzeigen, sodass eine schnellere und einfachere Problembehandlung möglich ist. Mit dem Microsoft Playwright-Testdienst können Sie Features schneller und sicherer freigeben.

Sind Sie bereit für die ersten Schritte? Springen Sie zu unserem Schnellstarthandbuch!

Nützliche Links

• Schnellstart: Ausführen von End-to-End-Tests im Maßstab
• Schnellstart: Einrichten kontinuierlicher End-to-End-Tests in verschiedenen Browsern und Betriebssystemen
• Entdecken von Features und Vorteilen
• Dokumentation
• Preise
• Feedback teilen

Loslegen

Führen Sie die folgenden Schritte aus, um Ihre vorhandene Playwright-Testsuite mit dem Dienst auszuführen.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, ein kostenloses Konto erstellen, bevor Sie beginnen.
• Ihrem Azure-Konto muss der Besitzer, Mitwirkendenoder einer der klassischen Administratorrollenzugewiesen werden.
• Azure CLI- muss auf dem Computer installiert sein, auf dem Sie Playwright-Tests ausführen.

Erstellen eines Arbeitsbereichs

1. Melden Sie sich mit Ihrem Azure-Konto beim Playwright-Portal an.

2. Erstellen Sie den Arbeitsbereich.

   

   Feld	Beschreibung
   Arbeitsbereichsname	Ein eindeutiger Name, um Ihren Arbeitsbereich zu identifizieren. Der Name darf keine Sonderzeichen oder Leerzeichen enthalten.
   Azure-Abonnement-	Wählen Sie ein Azure-Abonnement aus, in dem Sie den Arbeitsbereich erstellen möchten.
   Region	Hier werden Testlaufdaten für Ihren Arbeitsbereich gespeichert.

Wenn dieser Bildschirm nicht angezeigt wird, wählen Sie einen vorhandenen Arbeitsbereich aus, und wechseln Sie zum nächsten Abschnitt.

Installieren des Microsoft Playwright-Testpakets

1. Führen Sie diesen Befehl aus, um das Dienstpaket zu installieren.

   npm init @azure/microsoft-playwright-testing
   

Durch die Installation des Dienstpakets wird eine Dienstkonfigurationsdatei namens playwright.service.config.ts

Die Dienstkonfiguration dient folgendem:

• Direktes Authentifizieren von Playwright beim Microsoft Playwright-Testdienst.
• Fügen Sie Ihrer Konfiguration die Berichterstellung zu Microsoft Playwright-Tests hinzu.
• Überschreiben Sie bei Bedarf Timeouts für Dienstvorgänge.

Stellen Sie sicher, dass Ihr Projekt @playwright/test Version 1.47 oder höher verwendet.

Abrufen des Regionsendpunkts

1. Kopieren Sie im Playwright-Portalden Befehl unter Endpunkt "Region hinzufügen" in Ihrer einrichtung.

   

   Die Endpunkt-URL entspricht der Arbeitsbereichsregion. Je nachdem, welche Region Sie beim Erstellen des Arbeitsbereichs ausgewählt haben, wird möglicherweise eine andere Endpunkt-URL im Playwright-Portal angezeigt.

Einrichten der Umgebung

Stellen Sie sicher, dass die PLAYWRIGHT_SERVICE_URL, die Sie im vorherigen Schritt erhalten haben, in Ihrer Umgebung verfügbar ist.

Es wird empfohlen, dotenv Modul zum Verwalten Ihrer Umgebung zu verwenden. Mit dotenv verwenden Sie die .env Datei, um Ihre Umgebungsvariablen zu definieren.

Vergessen Sie nicht, .env Datei zu Ihrer .gitignore Datei hinzuzufügen, um Ihre geheimen Daten nicht freizugeben.

npm i --save-dev dotenv

.env Datei

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

Einrichten der Authentifizierung

Um Ihre Playwright-Tests im Microsoft Playwright-Testarbeitsbereich auszuführen, müssen Sie den Playwright-Client authentifizieren, in dem Sie die Tests mit dem Dienst ausführen. Dies könnte Ihr lokaler Entwicklungscomputer oder CI-Computer sein.

Der Dienst bietet zwei Authentifizierungsmethoden: Microsoft Entra ID und Zugriffstoken.

Die Microsoft Entra-ID verwendet Ihre Azure-Anmeldeinformationen, die eine Anmeldung bei Ihrem Azure-Konto erfordern, um sicheren Zugriff zu erhalten. Alternativ können Sie ein Zugriffstoken aus Ihrem Playwright-Arbeitsbereich generieren und in Ihrem Setup verwenden.

Einrichten der Authentifizierung mithilfe der Microsoft Entra-ID

Die Microsoft Entra-ID ist die Standardauthentifizierung und die empfohlene Authentifizierung für den Dienst. Auf Ihrem lokalen Entwicklungscomputer können Sie Azure CLI- verwenden, um sich anzumelden.

az login

HINWEIS: Wenn Sie Teil mehrerer Microsoft Entra-Mandanten sind, stellen Sie sicher, dass Sie sich beim Mandanten anmelden, zu dem Ihr Arbeitsbereich gehört. Sie können die Mandanten-ID über das Azure-Portal abrufen, siehe Suchen Ihres Microsoft Entra-Mandanten. Sobald Sie die ID erhalten haben, melden Sie sich mit dem Befehl az login --tenant <TenantID>

Einrichten der Authentifizierung mithilfe von Zugriffstoken

Sie können ein Zugriffstoken aus Ihrem Playwright-Testarbeitsbereich generieren und in Ihrem Setup verwenden. Aufgrund der erweiterten Sicherheit empfehlen wir jedoch dringend die Microsoft Entra-ID für die Authentifizierung. Zugriffstoken funktionieren zwar praktisch, funktionieren jedoch wie langlebige Kennwörter und sind anfälliger für kompromittierte Kennwörter.

1. Um die zugriffstokenbasierte Authentifizierung zu verwenden, Zugriffstokenbasierte Authentifizierung

2. Einrichten der Authentifizierung mithilfe von Zugriffstoken

Es wird dringend empfohlen, die Microsoft Entra-ID für die Authentifizierung für den Dienst zu verwenden. Wenn Sie Zugriffstoken verwenden, lesen Sie Verwalten von Zugriffstoken

HINWEIS: Wenn Sie Microsoft Playwright-Tests in CI-Pipelines verwenden möchten, müssen Sie die Authentifizierung mit dem Dienst über die Pipeline konfigurieren. Weitere Informationen finden Sie unter Einrichten von kontinuierlichen End-to-End-Tests in verschiedenen Browsern und Betriebssystemen

Ausführen der Tests

Führen Sie Playwright-Tests mit Browsern aus, die vom Dienst verwaltet werden, indem Sie die oben erstellte Konfiguration verwenden.

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

Nächste Schritte

• Führen Sie Tests in einer CI/CD-Pipeline aus.

• Erfahren Sie, wie Sie den Zugriff auf den erstellten Arbeitsbereich verwalten.

• Experimentieren Sie mit unterschiedlicher Anzahl von Mitarbeitern, um die optimale Konfiguration Ihrer Testsuitezu bestimmen.

Beitragend

Dieses Projekt begrüßt Beiträge und Vorschläge. Die meisten Beiträge erfordern, dass Sie einem Mitwirkenden-Lizenzvertrag (CLA) zustimmen, der erklärt, dass Sie das Recht haben, uns tatsächlich die Rechte zur Nutzung Ihres Beitrags zu gewähren. Weitere Informationen finden Sie unter https://cla.opensource.microsoft.com.

Wenn Sie eine Pullanfrage einreichen, bestimmt ein CLA-Bot automatisch, ob Sie einen CLA bereitstellen und die PR entsprechend dekorieren müssen (z. B. Statusüberprüfung, Kommentar). Folgen Sie einfach den Anweisungen des Bots. Sie müssen dies nur einmal über alle Reposs hinweg tun, indem Sie unsereN CLA verwenden.

Dieses Projekt hat den Microsoft Open Source Code of Conductübernommen. Weitere Informationen finden Sie im Code of Conduct FAQ oder wenden Sie sich an opencode@microsoft.com mit weiteren Fragen oder Kommentaren.

Handelsmarken

Dieses Projekt kann Marken oder Logos für Projekte, Produkte oder Dienstleistungen enthalten. Die autorisierte Verwendung von Microsoft-Marken oder Logos unterliegt und muss Markenrichtlinien von Microsoft & Markenrichtlinienfolgen. Die Verwendung von Microsoft-Marken oder Logos in geänderten Versionen dieses Projekts darf keine Verwirrung verursachen oder microsoft-Sponsoring implizieren. Jede Verwendung von Marken oder Logos von Drittanbietern unterliegt den Richtlinien dieses Drittanbieters.