Azure Toneelschrijver

Azure Playwright is een volledig beheerde Azure-service die gebruikmaakt van de cloud om u in staat te stellen Playwright-tests uit te voeren met een veel hogere parallellisatie tussen verschillende combinaties van besturingssysteem en browser tegelijk. Dit betekent snellere testruns met een bredere dekking van scenario's, waardoor de levering van functies wordt versneld zonder dat dit ten koste gaat van de kwaliteit. Met Playwright-werkplekken kun je functies sneller en met meer vertrouwen vrijgeven.

Klaar om aan de slag te gaan? Ga naar onze snelstartgids!

Handige links

• Snelstart: End-to-end-tests op schaal uitvoeren
• Snelstart: continue end-to-end-tests instellen in verschillende browsers en besturingssystemen
• Ontdek de functies en voordelen
• Documentatie
• prijsstelling
• Feedback delen

Get Started

Volg deze stappen om uw bestaande Playwright-testsuite met de service uit te voeren.

Vereiste voorwaarden

• Een Azure-account met een actief abonnement. Als u geen Azure-abonnement hebt, maak een gratis account voordat u begint.
• Aan uw Azure-account moet de rol Eigenaar, Inzender of een van de klassieke beheerdersrollen zijn toegewezen.
• Azure CLI moet zijn geïnstalleerd op de computer van waaruit u Playwright-tests uitvoert.

Een werkruimte maken

1. Meld u met uw Azure-account aan bij Azure Portal.

2. Creëer de werkruimte.

   • 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	Description
     Subscription	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 een lengte hebben tussen 3 en 64 tekens.
     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.

     

Azure Playwright-pakket installeren

1. Voer deze opdracht uit om het servicepakket te installeren

   npm init @azure/playwright
   

Als u het servicepakket installeert, wordt een serviceconfiguratiebestand gemaakt met de naam playwright.service.config.ts

De serviceconfiguratie dient om:

• Leid en authenticeer Playwright naar de Playwright-werkruimten.
• Time-outs voor servicebewerkingen overschrijven, indien nodig.

Zorg ervoor dat uw project versie 1.47 of hoger gebruikt @playwright/test .

Regio-eindpunt verkrijgen

1. Kopieer in de Azure Portal de opdracht onder Regio-eindpunt toevoegen in uw installatie-up.

   

   De URL van het eindpunt komt overeen met de regio van de werkruimte. Mogelijk ziet u een andere eindpunt-URL in de Azure Portal, afhankelijk van de regio die u hebt geselecteerd bij het maken van de werkruimte.

Omgeving instellen

Zorg ervoor dat datgene wat u in de PLAYWRIGHT_SERVICE_URL vorige stap hebt verkregen, beschikbaar is in uw omgeving.

We raden aan om de module te gebruiken dotenv om uw omgeving te beheren. Hiermee dotenv gebruikt u het .env bestand om uw omgevingsvariabelen te definiëren.

Vergeet niet om een bestand aan uw .gitignore bestand toe te voegen .env om uw geheimen niet te lekken.

npm i --save-dev dotenv

.env-bestand

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

Verificatie instellen

Als u uw Playwright-tests wilt uitvoeren in uw Azure Playwright-werkruimte, moet u de Playwright-client verifiëren waar u de tests met de service uitvoert. 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.

Autorisatie instellen met 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, zorgt u ervoor dat u zich aanmeldt bij de tenant waartoe uw werkruimte behoort. U kunt de tenant-id ophalen van 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 Azure Playwright-werkruimte en deze 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.

1. Als u verificatie op basis van toegangstokens wilt gebruiken, schakelt u verificatie op basis van toegangstokens in

2. Verificatie instellen met behulp van toegangstokens

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

NOTITIE: Als u Azure Playwright wilt gebruiken in CI-pijplijnen, moet u verificatie configureren met de service vanuit de pijplijn, zie Continu end-to-end testen instellen in verschillende browsers en besturingssystemen

Voer de tests uit

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

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

Volgende stappen

• Voer tests uit in een CI/CD-pijplijn.

• Meer informatie over het beheren van de toegang tot de gemaakte werkruimte.

• Experimenteer met een verschillend aantal werknemers om de optimale configuratie van uw testsuite te bepalen.

Contributing

Dit project verwelkomt bijdragen en suggesties. Voor de meeste bijdragen moet u akkoord gaan met een licentieovereenkomst voor bijdragers (CLA) waarin wordt verklaard dat u het recht hebt om ons de rechten te verlenen om uw bijdrage te gebruiken, en dat u dit ook daadwerkelijk doet. Zie https://cla.opensource.microsoft.com voor meer informatie.

Wanneer u een pull-aanvraag indient, bepaalt een CLA-bot automatisch of u een CLA moet verstrekken en de PR op de juiste manier moet inrichten (bijv. statuscontrole, opmerking). Volg gewoon de instructies van de bot. U hoeft dit slechts één keer te doen voor alle repo's met behulp van onze CLA.

In dit project is de Microsoft Open Source Code of Conduct overgenomen. Voor meer informatie zie de FAQ over de Gedragscode of neem contact op opencode@microsoft.com met aanvullende vragen of opmerkingen.

Handelsmerken

Dit project kan handelsmerken of logo's bevatten voor projecten, producten of diensten. Geautoriseerd gebruik van handelsmerken of logo's van Microsoft is onderworpen aan en moet voldoen aan de Richtlijnen voor handelsmerken en merken van Microsoft. Het gebruik van handelsmerken of logo's van Microsoft in gewijzigde versies van dit project mag geen verwarring veroorzaken of sponsoring door Microsoft impliceren. Elk gebruik van handelsmerken of logo's van derden is onderworpen aan het beleid van die derden.