Quickstart: Geavanceerde diagnostische gegevens uitvoeren met Playwright Workspaces-rapportage

In deze quickstart leert u hoe u fouten in playwright-tests kunt opsporen met behulp van de rapportagefunctie in Playwright Workspaces. Voer geavanceerde diagnostische gegevens uit voor uw Playwright-tests door uw testrapporten op te slaan in Azure Storage en deze weer te geven in Azure Portal met behulp van de Playwright Workspaces reporter.

Vereiste voorwaarden

• Een Azure-account met een actief abonnement. Als je geen Azure-abonnement hebt, maak dan een gratis account aan voordat je begint.
• Uw Azure-account heeft de rol Eigenaar, Inzender of een van de klassieke beheerdersrollen nodig.
• Een Playwright-project dat gebruikmaakt van Playwright runner en JavaScript SDK (NUnit en andere runners worden momenteel niet ondersteund). Als u geen project hebt, maakt u er een met behulp van de playwright-documentatie om aan de slag te gaan of gebruikt u het voorbeeldproject Playwright Workspaces.
• Het Playwright-project moet playwright-pakket (@plawright/test) versie 1.57 of hoger gebruiken.
• Azure CLI. Zie Azure CLI installeren als u geen Azure CLI hebt.
• De Playwright-werkruimte moet gebruikmaken van Microsoft Entra ID-verificatie. Verificatie met behulp van een toegangstoken wordt niet ondersteund voor rapportage.

Rapportage inschakelen en een opslagaccount koppelen aan een werkruimte

Om aan de slag te gaan met Playwright Workspaces-rapportage, moet u eerst rapportage in uw werkruimte inschakelen en een opslagaccount koppelen om uw rapportageartefacten op te slaan. U kunt aan de slag met een nieuwe werkruimte of uw bestaande werkruimte gebruiken.

RBAC-rollen (Role Based Access Control) toevoegen voor het gekoppelde opslagaccount

1. Open het gekoppelde opslagaccount in Azure Portal.

2. Ga naar het tabblad Toegangsbeheer (IAM).

   

3. Selecteer Roltoewijzing toevoegen.

   

4. Zoek en selecteer de rol Inzender voor opslagblobgegevens onder Functierollen van taak en klik op Volgende.

   

5. Selecteer en voeg alle leden toe die tests uitvoeren.

   

6. Klik op Controleren en toewijzen.

Playwright Workspaces-pakket installeren

Als u Playwright Workspaces wilt gebruiken, installeert u het Playwright Workspaces-pakket.

npm init @azure/playwright@latest

Met deze opdracht wordt een playwright.service.config.ts bestand gegenereerd dat Playwright omleidingt en verifieert naar Playwright Workspaces.

Als u dit bestand al hebt, wordt u door het pakket gevraagd het te overschrijven.

Reporter voor HTML- en Playwright-werkruimten inschakelen

Als u de rapportagefunctie Playwright Workspaces wilt gebruiken, schakelt u de html- en Playwright Workspaces-rapportfunctie in door de volgende instelling toe te voegen aan het playwright.service.config.ts-bestand:

reporter: [
    ["html", { open: "never" }], // HTML reporter must come first
    ["@azure/playwright/reporter"], // Azure reporter uploads HTML report
]

Artefacten inschakelen in uw Playwright-installatie

Zorg ervoor dat u in het playwright.config.ts bestand van uw project alle vereiste artefacten verzamelt.

use: 
{
    trace: 'on-first-retry',
    video:'retain-on-failure',
    screenshot:'on'
}

Het browsereindpunt configureren

In uw installatie moet u het regiospecifieke browsereindpunt opgeven. Het eindpunt is afhankelijk van de Azure-regio die u hebt geselecteerd bij het maken van de werkruimte.

Voer de volgende stappen uit om de URL van het browsereindpunt op te halen:

1. Meld u aan bij Azure Portal met uw Azure-account en navigeer naar uw werkruimte.

2. Selecteer de pagina Aan de slag .

   

3. In Het browsereindpunt toevoegen aan uw installatie kopieert u de eindpunt-URL.

   Zorg ervoor dat deze URL beschikbaar is in de PLAYWRIGHT_SERVICE_URL omgevingsvariabele.

   

Uw omgeving instellen

Als u uw omgeving wilt instellen, moet u de PLAYWRIGHT_SERVICE_URL omgevingsvariabele configureren met de waarde die u in de vorige stappen hebt verkregen.

Gebruik de dotenv module om uw omgeving te beheren. Met behulp van de dotenv, kunt u uw omgevingsvariabelen definiëren in het .env bestand.

1. Voeg de dotenv module toe aan uw project:

   npm i --save-dev dotenv
   

2. Voeg het volgende codefragment toe in playwright.service.config.ts:

   require('dotenv').config();
   

3. Maak een .env bestand naast het bestand in uw playwright.config.ts Playwright-project:

   PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}
   

   Zorg ervoor dat u de tijdelijke aanduiding voor tekst {MY-REGION-ENDPOINT} vervangt door de waarde die u eerder hebt gekopieerd.

Authenticatie instellen

Als u uw Playwright-tests wilt uitvoeren in uw Playwright-werkruimte, moet u de Playwright-client verifiëren waar u de tests uitvoert met de service. Verifieer vanaf uw lokale dev-machine of CI-machine.

Verificatie instellen met behulp van Microsoft Entra-id

Microsoft Entra ID is de enige ondersteunde verificatie voor het gebruik van de rapportagefunctie in Playwright Workspace. Vanaf uw lokale ontwikkelcomputer kunt u Azure CLI gebruiken om u aan te melden

az login

Uw tests uitvoeren met Playwright Workspaces

U hebt de configuratie voor het uitvoeren van playwright-tests in de cloud voltooid met Playwright Workspaces. U kunt de Playwright CLI gebruiken om uw tests uit te voeren of de Playwright Test Visual Studio Code-extensie gebruiken.

Fouten opsporen in testuitvoeringen en resultaten in Azure Portal

RBAC-rollen (Role Based Access Control) toevoegen voor het gekoppelde opslagaccount

1. Open het gekoppelde opslagaccount in Azure Portal.

2. Ga naar het tabblad Toegangsbeheer (IAM).

   

3. Selecteer Roltoewijzing toevoegen.

   

4. Zoek en selecteer onder Bevoorrechte beheerdersrollen de rol Inzender* en klik op Volgende.

   

5. Selecteer en voeg alle leden toe die de testrapporten kunnen bekijken.

   

6. Klik op Controleren + toewijzen.

(Alleen als tracering is ingeschakeld) Openbare traceringsviewer toestaan in het gekoppelde opslagaccount

1. Open het gekoppelde opslagaccount in Azure Portal.

2. Ga naar Instellingen -> Resource delen (CORS).

   

3. Voeg onder De Blob-service een nieuwe record toe:

   • Toegestane oorsprongen: https://trace.playwright.dev
   • Toegestane methoden: GET, OPTIONS
   • Maximale leeftijd: voer een waarde in tussen 0 en 2147483647.

   

4. Selecteer Opslaan.

Opgeslagen testrapporten weergeven in Azure Portal

U kunt nu problemen met de mislukte testcases oplossen in Azure Portal.

1. Nadat de testuitvoering is voltooid, genereert de rapportfunctie een koppeling naar de pagina Testuitvoeringen in Azure Portal. Open deze koppeling om gedetailleerde testresultaten en bijbehorende artefacten weer te geven.

   

2. De pagina Testuitvoeringen bevat alle benodigde informatie voor het oplossen van problemen. U kunt:

   • Bekijk gedetailleerde foutenlogboeken, teststappen en bijgevoegde artefacten, zoals schermopnamen of video's.
   • Navigeer rechtstreeks naar traceerviewer voor een diepere analyse.

   

3. Met Trace Viewer kunt u uw testuitvoering visueel doorlopen. U kunt:

   • Gebruik de tijdlijn om de muisaanwijzer over afzonderlijke stappen te bewegen, waarbij de paginastatus voor en na elke actie wordt weergegeven.
   • Inspecteer gedetailleerde logboeken, DOM-momentopnamen, netwerkactiviteit, fouten en console-uitvoer voor elke stap.