Microsoft Playwright Testing Preview

Microsoft Playwright Testing is een volledig beheerde Azure-service die gebruikmaakt van de cloud om Playwright-tests uit te voeren met veel hogere parallellisatie in verschillende combinaties van besturingssystemen tegelijk. Dit betekent dat snellere testuitvoeringen met een bredere dekking van scenario's, waardoor de levering van functies sneller verloopt zonder dat dit ten koste gaat van de kwaliteit. Met de service kunt u ook testresultaten en gerelateerde artefacten publiceren naar de service en deze weergeven in de serviceportal, zodat u sneller en eenvoudiger problemen kunt oplossen. Met de Testservice van Microsoft Playwright kunt u functies sneller en betrouwbaarder vrijgeven.

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

Nuttige koppelingen

• quickstart: End-to-end-tests uitvoeren op schaal
• quickstart: Doorlopend end-to-end testen instellen in verschillende browsers en besturingssystemen
• Functies en voordelen verkennen
• documentatie
• prijzen
• feedback delen

Slag

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

Voorwaarden

• Een Azure-account met een actief abonnement. Als u geen Azure-abonnement hebt, u een gratis account maken voordat u begint.
• Aan uw Azure-account moet de Eigenaar, inzenderof een van de klassieke beheerdersrollenzijn toegewezen.
• Azure CLI- moet worden geïnstalleerd op de computer waarop u Playwright-tests uitvoert.

Een werkruimte maken

1. Meld u aan bij de Playwright-portal met uw Azure-account.

2. Maak de werkruimte.

   

   Veld	Beschrijving
   werkruimtenaam	Een unieke naam om uw werkruimte te identificeren. De naam mag geen speciale tekens of spaties bevatten.
   Azure-abonnement	Selecteer een Azure-abonnement waarin u de werkruimte wilt maken.
   regio	Hier worden testuitvoeringsgegevens opgeslagen voor uw werkruimte.

Als u dit scherm niet ziet, selecteert u een bestaande werkruimte en gaat u naar de volgende sectie.

Microsoft Playwright Testing Package installeren

1. Voer deze opdracht uit om het servicepakket te installeren

   npm init @azure/microsoft-playwright-testing
   

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

De serviceconfiguratie dient voor het volgende:

• Direct en verifieer Playwright bij de Microsoft Playwright Testing-service.
• Voeg Microsoft Playwright Testing-rapportage toe aan uw configuratie.
• Overschrijf indien nodig time-outs voor servicebewerkingen.

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

Regio-eindpunt verkrijgen

1. Kopieer in de Playwright-portalde opdracht onder Regio-eindpunt toevoegen in uw.

   

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

Omgeving instellen

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

U wordt aangeraden dotenv module te gebruiken om uw omgeving te beheren. Met dotenv gebruikt u het .env-bestand om uw omgevingsvariabelen te definiëren.

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

npm i --save-dev dotenv

.env-bestand

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

Verificatie instellen

Als u uw Playwright-tests wilt uitvoeren in uw Microsoft Playwright Testing-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 verificatiemethoden: Microsoft Entra ID en Toegangstokens.

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. Nadat 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 Testing-werkruimte en deze gebruiken in uw installatie. We raden Microsoft Entra ID echter ten zeerste aan voor verificatie vanwege de verbeterde beveiliging. Toegangstokens, terwijl dit handig is, werken zoals wachtwoorden met een lange levensduur en zijn gevoeliger voor inbreuk.

1. Als u verificatie op basis van toegangstokens wilt gebruiken, op toegangstoken gebaseerde verificatie inschakelen

2. verificatie instellen met behulp van toegangstokens

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

OPMERKING: Als u Microsoft Playwright Testing in CI-pijplijnen wilt gebruiken, moet u verificatie met de service vanuit de pijplijn configureren. Zie doorlopend end-to-end testen in verschillende browsers en besturingssystemen in te stellen

De tests uitvoeren

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 toegang naar de gemaakte werkruimte.

• Experimenteer met verschillende werkrollen om de optimale configuratie van uw testsuite te bepalen.

Bijdragen

Dit project verwelkomt bijdragen en suggesties. Voor de meeste bijdragen moet u akkoord gaan met een Licentieovereenkomst voor inzenders (CLA) waarin wordt aangegeven dat u het recht hebt om, en daadwerkelijk, ons de rechten te verlenen om uw bijdrage te gebruiken. Ga naar https://cla.opensource.microsoft.comvoor meer informatie.

Wanneer u een pull-aanvraag indient, bepaalt een CLA-bot automatisch of u een CLA moet opgeven en de pull-aanvraag op de juiste wijze moet inrichten (bijvoorbeeld statuscontrole, opmerking). Volg gewoon de instructies van de bot. U hoeft dit slechts eenmaal te doen voor alle opslagplaatsen met behulp van onze CLA.

Dit project heeft de Microsoft Open Source-gedragscodeaangenomen. Zie de Veelgestelde vragen over gedragscodes voor meer informatie of neem contact op met opencode@microsoft.com met eventuele 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 onderhevig aan en moet voldoen aan Merkrichtlijnen van Microsoft &. Het gebruik van Microsoft-handelsmerken of logo's in gewijzigde versies van dit project mag geen verwarring veroorzaken of Microsoft Sponsorship impliceren. Elk gebruik van handelsmerken of logo's van derden is onderhevig aan het beleid van deze derde partij.