Förhandsversion av Microsoft Playwright Testing

Microsoft Playwright Testing är en fullständigt hanterad Azure-tjänst som använder molnet så att du kan köra Playwright-tester med mycket högre parallellisering mellan olika kombinationer av operativsystem och webbläsare samtidigt. Det innebär snabbare testkörningar med bredare scenariotäckning, vilket hjälper till att påskynda leveransen av funktioner utan att offra kvaliteten. Med tjänsten kan du också publicera testresultat och relaterade artefakter till tjänsten och visa dem i tjänstportalen, vilket möjliggör snabbare och enklare felsökning. Med Microsoft Playwright Testing Service kan du släppa funktioner snabbare och mer säkert.

Är du redo att komma igång? Hoppa in i vår snabbstartsguide!

Användbara länkar

• Snabbstart: Köra tester från slutpunkt till slutpunkt i stor skala
• Snabbstart: Konfigurera kontinuerlig testning från slutpunkt till slutpunkt för olika webbläsare och operativsystem
• Utforska funktioner och fördelar
• dokumentation
• prissättning
• Dela feedback

Sätta igång

Följ de här stegen för att köra din befintliga Drama-testsvit med tjänsten.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Om du inte har en Azure-prenumeration skapa ett kostnadsfritt konto innan du börjar.
• Ditt Azure-konto måste tilldelas Owner, Contributoreller någon av de klassiska administratörsrollerna.
• Azure CLI- måste installeras på datorn där du kör Playwright-tester.

Skapa en arbetsyta

1. Logga in på Playwright-portalen med ditt Azure-konto.

2. Skapa arbetsytan.

   

   Fält	Beskrivning
   Arbetsytans namn	Ett unikt namn för att identifiera din arbetsyta. Namnet får inte innehålla specialtecken eller blanksteg.
   Azure-prenumeration	Välj en Azure-prenumeration där du vill skapa arbetsytan.
   region	Det är här testkörningsdata lagras för din arbetsyta.

Om du inte ser den här skärmen väljer du en befintlig arbetsyta och går till nästa avsnitt.

Installera Testpaket för Microsoft Playwright

1. Kör det här kommandot för att installera tjänstpaketet

   npm init @azure/microsoft-playwright-testing
   

När du installerar tjänstpaketet skapas en tjänstkonfigurationsfil med namnet playwright.service.config.ts

Tjänstkonfigurationen tjänar till att:

• Dirigera och autentisera Dramatiker till Microsoft Playwright Testing-tjänsten.
• Lägg till Microsoft Playwright Testing-rapportering i din konfiguration.
• Åsidosätt tidsgränser för tjänståtgärder om det behövs.

Kontrollera att projektet använder @playwright/test version 1.47 eller senare.

Hämta regionslutpunkt

1. I Playwright-portalenkopierar du kommandot under Lägg till regionslutpunkt i din konfiguration.

   

   Slutpunkts-URL:en motsvarar arbetsytans region. Du kan se en annan slutpunkts-URL i Playwright-portalen, beroende på vilken region du valde när du skapade arbetsytan.

Konfigurera miljö

Kontrollera att den PLAYWRIGHT_SERVICE_URL som du fick i föregående steg är tillgänglig i din miljö.

Vi rekommenderar att du använder dotenv modul för att hantera din miljö. Med dotenv använder du filen .env för att definiera miljövariabler.

Glöm inte att lägga till .env fil i din .gitignore-fil för att inte läcka dina hemligheter.

npm i --save-dev dotenv

.env fil

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

Konfigurera autentisering

Om du vill köra dina Playwright-tester på din Microsoft Playwright Testing-arbetsyta måste du autentisera Playwright-klienten där du kör testerna med tjänsten. Det kan vara din lokala utvecklingsdator eller CI-dator.

Tjänsten erbjuder två autentiseringsmetoder: Microsoft Entra-ID och åtkomsttoken.

Microsoft Entra-ID använder dina Azure-autentiseringsuppgifter och kräver en inloggning till ditt Azure-konto för säker åtkomst. Du kan också generera en åtkomsttoken från din Playwright-arbetsyta och använda den i konfigurationen.

Konfigurera autentisering med Microsoft Entra-ID

Microsoft Entra-ID är standard och rekommenderad autentisering för tjänsten. Från din lokala utvecklingsdator kan du använda Azure CLI- för att logga in

az login

NOTE: Om du ingår i flera Microsoft Entra-klienter kontrollerar du att du loggar in på den klientorganisation där arbetsytan tillhör. Du kan hämta klient-ID:t från Azure-portalen, se Hitta din Microsoft Entra-klientorganisation. När du har fått ID:t loggar du in med kommandot az login --tenant <TenantID>

Konfigurera autentisering med hjälp av åtkomsttoken

Du kan generera en åtkomsttoken från din Playwright Testing-arbetsyta och använda den i konfigurationen. Vi rekommenderar dock starkt Microsoft Entra-ID för autentisering på grund av den förbättrade säkerheten. Åtkomsttoken fungerar, även om de är praktiska, som långlivade lösenord och är mer mottagliga för att komprometteras.

1. Om du vill använda åtkomsttokenbaserad autentisering Aktivera åtkomsttokenbaserad autentisering

2. Konfigurera autentisering med hjälp av åtkomsttoken

Vi rekommenderar starkt att du använder Microsoft Entra-ID för autentisering till tjänsten. Om du använder åtkomsttoken kan du läsa Hantera åtkomsttoken

OBS! Om du vill använda Microsoft Playwright Testing i CI-pipelines måste du konfigurera autentisering med tjänsten från pipeline, se konfigurera kontinuerlig testning från slutpunkt till slutpunkt i olika webbläsare och operativsystem

Kör testerna

Kör Playwright-tester mot webbläsare som hanteras av tjänsten med den konfiguration som du skapade ovan.

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

Nästa steg

• Kör tester i en CI/CD-pipeline.

• Lär dig hur du hantera åtkomst till den skapade arbetsytan.

• Experimentera med olika antal arbetare för att fastställa den optimala konfigurationen av din testsvit.

Bidragande

Det här projektet välkomnar bidrag och förslag. De flesta bidrag kräver att du godkänner ett licensavtal för deltagare (CLA) som förklarar att du har rätt att, och faktiskt gör det, ge oss rätten att använda ditt bidrag. Mer information finns i https://cla.opensource.microsoft.com.

När du skickar en pull-begäran avgör en CLA-robot automatiskt om du behöver tillhandahålla en CLA och dekorera PR på rätt sätt (t.ex. statuskontroll, kommentar). Följ bara anvisningarna från roboten. Du behöver bara göra detta en gång för alla lagringsplatser med vår CLA.

Det här projektet har antagit Microsoft Open Source Code of Conduct. Mer information finns i vanliga frågor och svar om uppförandekod eller kontakta opencode@microsoft.com med ytterligare frågor eller kommentarer.

Varumärken

Det här projektet kan innehålla varumärken eller logotyper för projekt, produkter eller tjänster. Auktoriserad användning av Microsofts varumärken eller logotyper omfattas av och måste följa Microsofts varumärkesriktlinjer för & varumärke. Användning av Microsofts varumärken eller logotyper i ändrade versioner av det här projektet får inte orsaka förvirring eller innebära Microsoft-sponsring. All användning av varumärken eller logotyper från tredje part omfattas av dessa tredjepartsprinciper.