Quickstart: End-to-end-tests op schaal uitvoeren met Playwright Workspaces

In deze quickstart leert u hoe u playwright-tests uitvoert met uiterst parallelle cloudbrowsers met behulp van Playwright Workspaces. Gebruik de cloudinfrastructuur om uw toepassing te valideren in meerdere browsers, apparaten en besturingssystemen.

Nadat u deze quickstart hebt voltooid, hebt u een Playwright-werkruimte om uw Playwright-tests op schaal uit te voeren.

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. Als u geen project hebt, maakt u er een met behulp van de playwright-documentatie om aan de slag te gaan of gebruikt u ons voorbeeldproject Playwright Workspaces.
Azure CLI. Zie Azure CLI installeren als u geen Azure CLI hebt.

Een werkruimte maken

Om aan de slag te gaan met het uitvoeren van playwright-tests in cloudbrowsers, moet u eerst een Playwright-werkruimte maken.

Meld u aan bij het Azure-portaal.
Selecteer de menuknop in de linkerbovenhoek van de portal en selecteer vervolgens Een resource maken.
Typ Playwright Workspaces in het zoekvak.
Selecteer de kaart Werkruimten voor toneelschrijvers en selecteer vervolgens Maken.

Geef de volgende informatie op om een nieuwe Playwright-werkruimte te configureren:

Veld	Beschrijving
Abonnement	Selecteer het Azure-abonnement dat u wilt gebruiken voor deze Playwright-werkruimte.
Resourcegroep	Selecteer een bestaande resourcegroep. Of selecteer Nieuwe maken en voer vervolgens een unieke naam in voor de nieuwe resourcegroep.
Naam	Voer een unieke naam in om uw werkruimte te identificeren. De naam mag alleen bestaan uit alfanumerieke tekens en afbreekstreepjes en mag tussen 3 en 24 tekens lang zijn.
Plaats	Selecteer een geografische locatie om uw werkruimte te hosten. Deze locatie bepaalt ook waar de testresultaten worden opgeslagen.

Opmerking

U kunt desgewenst meer details configureren op het tabblad Tags . Tags zijn naam-/waardeparen waarmee u resources kunt categoriseren en geconsolideerde facturering kunt weergeven door dezelfde tag toe te passen op meerdere resources en resourcegroepen.

Nadat u klaar bent met het configureren van de resource, selecteert u Beoordelen en maken.
Controleer alle configuratie-instellingen en selecteer Maken om de implementatie van de Playwright-werkruimte te starten.

Wanneer het proces is voltooid, wordt er een bericht weergegeven dat de implementatie is geslaagd.
Selecteer Ga naar resource om de nieuwe werkruimte te bekijken.

Playwright Workspaces-pakket installeren

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

npm init @azure/playwright@latest

Hiermee wordt een playwright.service.config.ts bestand gegenereerd dat dient om Playwright naar Playwright Workspaces te leiden en te verifiëren.

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

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

dotnet add package Azure.Developer.Playwright.NUnit

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:

Meld u aan bij Azure Portal met uw Azure-account en navigeer naar uw werkruimte.
Selecteer de pagina Aan de slag .
In Het browsereindpunt toevoegen aan uw installatie kopieert u de eindpunt-URL.

Zorg ervoor dat deze URL beschikbaar is in PLAYWRIGHT_SERVICE_URL de 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.

U wordt aangeraden de dotenv module te gebruiken om uw omgeving te beheren. Met dotenv, definieert u uw omgevingsvariabelen in het .env bestand.

Voeg de dotenv module toe aan uw project:
```
npm i --save-dev dotenv
```
Voeg het volgende codefragment toe in playwright.service.config.ts:
```
require('dotenv').config();
```
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.

Serviceconfiguratie instellen

Maak een bestand PlaywrightServiceSetup.cs in uw project met de volgende inhoud.

using Azure.Developer.Playwright.NUnit;
using Azure.Identity;

namespace PlaywrightTests; // Remember to change this as per your project namespace

[SetUpFixture]
public class PlaywrightServiceNUnitSetup  : PlaywrightServiceBrowserNUnit
{
    public PlaywrightServiceNUnitSetup() : base(
        credential: new DefaultAzureCredential()
    ) 
    {}
}

Opmerking

Zorg ervoor dat uw project versie 1.50 of hoger gebruikt Microsoft.Playwright.NUnit .

Verificatie 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. Dit kan uw lokale dev-machine of CI-machine zijn.

De service biedt twee authenticatiemethoden: Microsoft Entra ID en Access Tokens.

Microsoft Entra ID maakt gebruik van uw Azure-referenties, waarvoor een aanmelding bij uw Azure-account is vereist voor beveiligde toegang. U kunt ook een toegangstoken genereren vanuit uw Playwright-werkruimte en deze gebruiken in uw installatie.

Verificatie instellen met behulp van Microsoft Entra-id

Microsoft Entra-id is de standaard- en aanbevolen verificatie voor de service. Vanaf uw lokale ontwikkelcomputer kunt u Azure CLI- gebruiken om u aan te melden

az login

Opmerking

Als u deel uitmaakt van meerdere Microsoft Entra-tenants, moet u zich aanmelden bij de tenant waartoe uw werkruimte behoort. U kunt de tenant-id ophalen uit de Azure-portal. Zie Uw Microsoft Entra-tenant zoeken. Zodra u de id hebt getympt, meldt u zich aan met behulp van de opdracht az login --tenant <TenantID>

Verificatie instellen met behulp van toegangstokens

U kunt een toegangstoken genereren vanuit uw Playwright-werkruimte en dit gebruiken in uw installatie. We raden Microsoft Entra ID echter ten zeerste aan voor verificatie vanwege de verbeterde beveiliging. Toegangstokens zijn weliswaar handig, maar functioneren als wachtwoorden met een lange levensduur en zijn vatbaarder voor compromittering.

Verificatie met toegangstokens is standaard uitgeschakeld. Schakel verificatie op basis van toegangstokens in.
Verificatie instellen met behulp van toegangstokens.

Waarschuwing

We raden u ten zeerste aan om Microsoft Entra-ID te gebruiken voor verificatie bij de service. Als u toegangstokens gebruikt, raadpleegt u Toegangstokens beheren.

Uw tests op schaal uitvoeren met Playwright Workspaces

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

Eén test uitvoeren met de service

Met Playwright Workspaces worden kosten in rekening gebracht op basis van het totale aantal testminuten. Als u een eerste gebruiker bent of aan de slag gaat met een gratis proefversie, kunt u beginnen met het uitvoeren van één test in plaats van uw volledige testpakket om te voorkomen dat de limieten voor de gratis proefversie worden uitgeput.

Nadat u hebt gevalideerd dat de test is uitgevoerd, kunt u de belasting van de test geleidelijk verhogen door meer tests met de service uit te voeren.

Voer de volgende stappen uit om één Playwright-test uit te voeren met Playwright Workspaces:

Playwright CLI
Visual Studio Code

Als u de Playwright CLI wilt gebruiken om uw tests uit te voeren met Playwright Workspaces, geeft u het serviceconfiguratiebestand door als een opdrachtregelparameter.

Een terminalvenster openen.
Voer de volgende opdracht in om uw Playwright-test uit te voeren op externe browsers in uw werkruimte:

Vervang de tijdelijke aanduiding voor tekst {name-of-file.spec.ts} door de naam van het testspecificatiebestand.
```
npx playwright test {name-of-file.spec.ts} --config=playwright.service.config.ts
```
Nadat de test is voltooid, kunt u de teststatus in de terminal bekijken.
```
Running 1 test using 1 worker
    1 passed (2.2s)

To open last HTML report run:

npx playwright show-report
```

Als u één Playwright-test wilt uitvoeren in Visual Studio Code met Playwright Workspaces, selecteert u het serviceconfiguratiebestand in de weergave Test Explorer . Selecteer en voer vervolgens de test uit in de lijst met tests.

Installeer de Playwright Test Visual Studio Code-extensie.
Open de weergave Test Explorer in de activiteitenbalk.

De testverkenner detecteert automatisch uw Playwright-tests en de serviceconfiguratie in uw project.
Selecteer Standaardprofiel selecteren en selecteer vervolgens uw standaardprojecten in het serviceconfiguratiebestand.

U ziet dat de serviceuitvoeringsprofielen afkomstig zijn van het playwright.service.config.ts bestand dat u eerder hebt toegevoegd.

Door een standaardprofiel in te stellen, kunt u automatisch uw tests uitvoeren met de service of meerdere Playwright-projecten tegelijk uitvoeren.
Selecteer in de lijst met tests de knop Test uitvoeren naast een test om deze uit te voeren.

De test wordt uitgevoerd op de projecten die u in het standaardprofiel hebt geselecteerd. Als u een of meer projecten uit de serviceconfiguratie hebt geselecteerd, wordt de test uitgevoerd op externe browsers in uw werkruimte.

Aanbeveling

U kunt nog steeds fouten opsporen in uw testcode wanneer u uw tests uitvoert op externe browsers met behulp van de knop Foutopsporingstest .
U kunt de testresultaten rechtstreeks in Visual Studio Code bekijken.

U kunt nu meerdere tests uitvoeren met de service of uw hele testpakket uitvoeren op externe browsers.

Waarschuwing

Afhankelijk van de grootte van uw testpakket, worden er mogelijk extra kosten in rekening gebracht voor de testminuten en testresultaten buiten uw toegewezen gratis testminuten en gratis testresultaten.

Een volledige testsuite uitvoeren met de service

Nu u hebt gevalideerd dat u één test kunt uitvoeren met Playwright Workspaces, kunt u een volledig Playwright-testpakket op schaal uitvoeren.

Voer de volgende stappen uit om een volledig Playwright-testpakket uit te voeren met Playwright Workspaces:

Playwright CLI
Visual Studio Code

Wanneer u meerdere Playwright-tests of een volledige testsuite met Playwright Workspaces uitvoert, kunt u desgewenst het aantal parallelle werkrollen opgeven als opdrachtregelparameter.

Een terminalvenster openen.
Voer de volgende opdracht in om uw Playwright-testpakket uit te voeren op externe browsers in uw werkruimte:
```
npx playwright test --config=playwright.service.config.ts --workers=20
```
Afhankelijk van de grootte van uw testpakket voert deze opdracht uw tests uit op maximaal 20 parallelle werkrollen.

Nadat de test is voltooid, kunt u de teststatus in de terminal bekijken.
```
Running 6 tests using 6 workers
    6 passed (18.2s)
```

Voer Playwright-tests uit op browsers die worden beheerd door de service met behulp van de configuratie die u hierboven hebt gemaakt.

dotnet test -- NUnit.NumberOfTestWorkers=20

Nadat de testuitvoering is voltooid, kunt u de teststatus in de terminal bekijken.

Starting test execution, please wait...

A total of 100 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     100, Skipped:     0, Total:     100, Duration: 59 s - PlaywrightTestsNUnit.dll (net7.0)

Workload updates are available. Run `dotnet workload list` for more information.

Parallelle werkrolconfiguratie optimaliseren

Zodra uw tests soepel worden uitgevoerd met de service, experimenteert u met verschillende parallelle werkrollen om de optimale configuratie te bepalen waarmee de voltooiingstijd van de test wordt geminimaliseerd.

Met Playwright Workspaces kunt u maximaal 50 parallelle werkrollen uitvoeren. Verschillende factoren zijn van invloed op de beste configuratie voor uw project, zoals de CPU, het geheugen en de netwerkbronnen van uw clientcomputer, de belastingafhandelingscapaciteit van de doeltoepassing en het type acties dat in uw tests wordt uitgevoerd.

U kunt het aantal parallelle werkrollen opgeven op de opdrachtregel van playwright CLI of de workers eigenschap configureren in het playwright-serviceconfiguratiebestand.

U kunt het aantal parallelle werkrollen opgeven op de opdrachtregel van playwright CLI of de NumberOfTestWorkers eigenschap in het .runsettings bestand configureren.

Meer informatie over het bepalen van de optimale configuratie voor het optimaliseren van de voltooiing van het testpakket.

Volgende stap

U hebt een Playwright-werkruimte gemaakt in Azure Portal en uw Playwright-tests uitvoeren op cloudbrowsers.

Ga naar de volgende quickstart om doorlopend end-to-end testen in te stellen door playwright-tests uit te voeren in uw CI/CD-werkstroom.

Doorlopend end-to-end testen instellen in CI/CD

Feedback

Is deze pagina nuttig?

Last updated on 2025-08-08

Delen via

Quickstart: End-to-end-tests op schaal uitvoeren met Playwright Workspaces

Vereiste voorwaarden

Een werkruimte maken

Playwright Workspaces-pakket installeren

Het browsereindpunt configureren

Uw omgeving instellen

Serviceconfiguratie instellen

Verificatie instellen

Verificatie instellen met behulp van Microsoft Entra-id

Verificatie instellen met behulp van toegangstokens

Uw tests op schaal uitvoeren met Playwright Workspaces

Eén test uitvoeren met de service

Een volledige testsuite uitvoeren met de service

Parallelle werkrolconfiguratie optimaliseren

Volgende stap

Feedback

Aanvullende resources