Rychlý start: Spouštění komplexních testů ve velkém měřítku pomocí pracovních prostorů Playwright

V tomto rychlém startu se dozvíte, jak spouštět testy Playwright s vysoce paralelními cloudovými prohlížeči pomocí pracovních prostorů Playwright. Použijte cloudovou infrastrukturu k ověření aplikace v různých prohlížečích, zařízeních a operačních systémech.

Po dokončení tohoto rychlého startu máte pracovní prostor Playwright ke spuštění testů Playwright ve velkém měřítku.

Požadavky

• Účet Azure s aktivním předplatným. Pokud nemáte předplatné Azure, vytvořte si bezplatný účet před zahájením.
• Váš účet Azure potřebuje roli vlastníka, přispěvatele nebo některé z klasických rolí správce.
• Projekt playwright. Pokud projekt nemáte, vytvořte si ho pomocí úvodní dokumentace playwright nebo použijte ukázkový projekt Playwright Workspaces.
• Azure CLI. Pokud azure CLI nemáte, přečtěte si téma Instalace Azure CLI.

Vytvoření pracovního prostoru

Pokud chcete začít se spouštěním testů Playwright v cloudových prohlížečích, musíte nejprve vytvořit pracovní prostor Playwright.

1. Přihlaste se do Azure Portalu.

2. V levém horním rohu portálu vyberte tlačítko nabídky a pak vyberte Vytvořit prostředek .

   

3. Do vyhledávacího pole zadejte Playwright Workspaces .

4. Vyberte kartu Pracovní prostory dramatika a poté vyberte možnost Vytvořit.

   

5. Zadejte následující informace pro konfiguraci nové pracovní plochy Playwright:

   Obor	Popis
   Předplatné	Vyberte předplatné Azure, které chcete použít pro tento pracovní prostor Playwright.
   Skupina zdrojů	Vyberte existující skupinu prostředků. Nebo vyberte Vytvořit nový a zadejte jedinečný název nové skupiny prostředků.
   název	Zadejte jedinečný název pro identifikaci pracovního prostoru. Název se může skládat jenom z alfanumerických znaků a pomlček a má délku mezi 3 a 24 znaky.
   Umístění	Vyberte zeměpisné umístění pro hostování vašeho pracovního prostoru. Toto umístění také určuje, kde jsou uloženy výsledky provedení testu.

   Poznámka:

   Volitelně můžete nakonfigurovat další podrobnosti na kartě Značky . Značky jsou páry názvů a hodnot, které umožňují kategorizovat prostředky a zobrazit konsolidovanou fakturaci použitím stejné značky u více prostředků a skupin prostředků.

6. Po dokončení konfigurace prostředku vyberte Zkontrolovat a vytvořit.

7. Zkontrolujte všechna nastavení konfigurace a výběrem možnosti Vytvořit spusťte nasazení pracovní plochy Playwright.

   Po dokončení procesu se zobrazí zpráva o úspěšném nasazení.

8. Pokud chcete zobrazit nový pracovní prostor, vyberte Přejít k prostředku.

   

Instalace balíčku Playwright Workspaces

Pokud chcete službu používat, nainstalujte balíček Playwright Workspaces.

npm init @azure/playwright@latest

Tím se playwright.service.config.ts vygeneruje soubor, který slouží k přímému a ověření playwrightových pracovních prostorů.

Pokud už tento soubor máte, balíček vás vyzve k jeho přepsání.

Pokud chcete službu používat, nainstalujte balíček Playwright Workspaces.

dotnet add package Azure.Developer.Playwright.NUnit

Konfigurace koncového bodu prohlížeče

V nastavení musíte zadat koncový bod prohlížeče specifický pro danou oblast. Koncový bod závisí na oblasti Azure, kterou jste vybrali při vytváření pracovního prostoru.

Pokud chcete získat adresu URL koncového bodu prohlížeče, proveďte následující kroky:

1. Přihlaste se k webu Azure Portal pomocí svého účtu Azure a přejděte do svého pracovního prostoru.

2. Vyberte stránku Začínáme .

   

3. V části Přidání koncového bodu prohlížeče do nastavení zkopírujte adresu URL koncového bodu.

   Ujistěte se, že je tato adresa URL dostupná v PLAYWRIGHT_SERVICE_URL proměnné prostředí.

   

Nastavení prostředí

Pokud chcete nastavit prostředí, musíte nakonfigurovat PLAYWRIGHT_SERVICE_URL proměnnou prostředí s hodnotou, kterou jste získali v předchozích krocích.

Ke správě prostředí doporučujeme použít dotenv modul. V dotenvsouboru .env definujete proměnné prostředí.

1. Přidejte modul dotenv do projektu:

   npm i --save-dev dotenv
   

2. Do playwright.service.config.ts přidejte následující fragment kódu:

   require('dotenv').config();
   

3. Vytvořte .env soubor společně se souborem playwright.config.ts v projektu Playwright:

   PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}
   

   Nezapomeňte zástupný text nahradit {MY-REGION-ENDPOINT} hodnotou, kterou jste zkopírovali dříve.

Nastavení konfigurace služby

V projektu vytvořte soubor PlaywrightServiceSetup.cs s následujícím obsahem.

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()
    ) 
    {}
}

Poznámka:

Ujistěte se, že váš projekt používá Microsoft.Playwright.NUnit verzi 1.50 nebo vyšší.

Nastavení ověřování

Pokud chcete spustit testy Playwright v pracovním prostoru Playwright, musíte ověřit klienta Playwright, ve kterém testy spouštíte ve službě. Může to být místní vývojový počítač nebo počítač CI.

Služba nabízí dva způsoby ověřování: Microsoft Entra ID a Access Tokens.

Microsoft Entra ID používá vaše přihlašovací údaje Azure, které vyžadují přihlášení k vašemu účtu Azure pro zabezpečený přístup. Případně můžete vygenerovat přístupový token z pracovního prostoru Playwright a použít ho v nastavení.

Nastavení ověřování pomocí Microsoft Entra ID

Id Microsoft Entra je výchozí a doporučené ověřování pro službu. Z místního vývojového počítače můžete k přihlášení použít Azure CLI.

az login

Poznámka:

Pokud jste součástí více tenantů Microsoft Entra, ujistěte se, že se přihlásíte k tenantovi, do kterého patří váš pracovní prostor. ID tenanta můžete získat z webu Azure Portal. Viz Vyhledání tenanta Microsoft Entra. Jakmile získáte ID, přihlaste se pomocí příkazu. az login --tenant <TenantID>

Nastavení ověřování pomocí přístupových tokenů

Přístupový token můžete vygenerovat z pracovního prostoru Playwright a použít ho v nastavení. Důrazně však doporučujeme Microsoft Entra ID pro ověřování kvůli jeho vylepšenému zabezpečení. Přístupové tokeny, i když jsou pohodlné, fungují jako dlouhodobá hesla a jsou náchylnější ke kompromitaci.

1. Ověřování pomocí přístupových tokenů je ve výchozím nastavení zakázané. Chcete-li použít, povolte ověřování na základě přístupového tokenu.

2. Nastavte ověřování pomocí přístupových tokenů.

Upozornění

Důrazně doporučujeme použít Microsoft Entra ID pro ověření ke službě. Pokud používáte přístupové tokeny, přečtěte si téma Správa přístupových tokenů.

Spouštění testů ve velkém měřítku pomocí pracovních prostorů Playwright

Teď jste připravili konfiguraci pro spouštění testů Playwright v cloudu pomocí pracovních prostorů Playwright. Ke spuštění testů můžete použít buď rozhraní příkazového řádku Playwright, nebo můžete použít rozšíření Playwright Test Visual Studio Code.

Spuštění jednoho testu se službou

U pracovních prostorů Playwright se vám budou účtovat poplatky na základě celkového počtu testovacích minut. Pokud jste uživatelem poprvé nebo začínáte s bezplatnou zkušební verzí, můžete začít spuštěním jednoho testu místo úplné sady testů, abyste se vyhnuli vyčerpání bezplatných zkušebních limitů.

Po ověření úspěšného spuštění testu můžete postupně zvýšit zátěž testu spuštěním dalších testů se službou.

Provedením následujících kroků spusťte jeden test Playwright s pracovními prostory Playwright:

Playwright CLI

Pokud chcete použít playwright CLI ke spuštění testů pomocí pracovních prostorů Playwright, předejte konfigurační soubor služby jako parametr příkazového řádku.

1. Otevřete okno terminálu.

2. Zadáním následujícího příkazu spusťte test Playwright ve vzdálených prohlížečích v pracovním prostoru:

   {name-of-file.spec.ts} Zástupný text nahraďte názvem souboru specifikace testu.

   npx playwright test {name-of-file.spec.ts} --config=playwright.service.config.ts
   

   Po dokončení testu můžete zobrazit stav testu v terminálu.

   Running 1 test using 1 worker
       1 passed (2.2s)
   
   To open last HTML report run:
   
   npx playwright show-report
   

Visual Studio Code

Pokud chcete spustit jeden test Playwright v editoru Visual Studio Code s pracovními prostory Playwright, vyberte v zobrazení Průzkumníka testů konfigurační soubor služby. Pak vyberte a spusťte test ze seznamu testů.

1. Nainstalujte rozšíření Playwright Test Visual Studio Code.

2. Otevřete zobrazení Průzkumníka testů na panelu aktivit.

   Průzkumník testů automaticky rozpozná testy Playwright a konfiguraci služby v projektu.

   

3. Vyberte Výchozí profil a pak v konfiguračním souboru služby vyberte výchozí projekty.

   Všimněte si, že profily spuštění služby pocházejí ze playwright.service.config.ts souboru, který jste přidali dříve.

   Nastavením výchozího profilu můžete automaticky spouštět testy se službou nebo současně spouštět více projektů Playwright.

   

4. V seznamu testů vyberte tlačítko Spustit test vedle testu a spusťte ho.

   Test se spustí na projektech, které jste vybrali ve výchozím profilu. Pokud jste vybrali jeden nebo více projektů z konfigurace služby, test se spustí ve vzdálených prohlížečích ve vašem pracovním prostoru.

   

   Tip

   Při spouštění testů ve vzdálených prohlížečích můžete stále ladit svůj testovací kód pomocí tlačítka Ladit test .

5. Výsledky testu můžete zobrazit přímo v editoru Visual Studio Code.

   

Teď můžete se službou spustit více testů nebo spustit celou sadu testů ve vzdálených prohlížečích.

Upozornění

V závislosti na velikosti testovací sady se vám můžou účtovat další poplatky za testovací minuty a výsledky testů nad rámec přidělených bezplatných testovacích minut a bezplatných výsledků testů.

Spuštění úplné testovací sady se službou

Teď, když jste ověřili, že můžete spustit jeden test pomocí pracovních prostorů Playwright, můžete spustit úplnou sadu testů Playwright ve velkém měřítku.

Provedením následujících kroků spusťte úplnou sadu testů Playwright s pracovními prostory Playwright:

Playwright CLI

Když spustíte více testů Playwright nebo úplnou sadu testů s pracovními prostory Playwright, můžete volitelně zadat počet paralelních pracovních procesů jako parametr příkazového řádku.

1. Otevřete okno terminálu.

2. Zadáním následujícího příkazu spusťte sadu testů Playwright ve vzdálených prohlížečích v pracovním prostoru:

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

   V závislosti na velikosti sady testů spustí tento příkaz testy až na 20 paralelních pracovních procesů.

   Po dokončení testu můžete zobrazit stav testu v terminálu.

   Running 6 tests using 6 workers
       6 passed (18.2s)
   

Visual Studio Code

Spuštění sady testů Playwright v editoru Visual Studio Code pomocí pracovních prostorů Playwright:

1. Otevřete zobrazení Průzkumníka testů na panelu aktivit.

2. Vyberte tlačítko Spustit testy a spusťte všechny testy pomocí pracovních prostorů Playwright.

   Při spuštění všech testů se použije výchozí profil. V předchozím kroku jste nakonfigurovali výchozí profil tak, aby používal projekty z konfigurace služby.

   

   Tip

   Při spouštění testů ve vzdálených prohlížečích můžete stále ladit svůj testovací kód pomocí tlačítka Ladění testů .

3. Případně můžete ze seznamu vybrat konkrétní konfiguraci služby, která spustí testy pouze pro konkrétní konfiguraci prohlížeče.

   

4. Všechny výsledky testů můžete zobrazit na kartě Výsledky testu .

Spusťte testy Playwright v prohlížečích spravovaných službou pomocí konfigurace, kterou jste vytvořili výše.

dotnet test -- NUnit.NumberOfTestWorkers=20

Po dokončení testovacího spuštění můžete zobrazit stav testu v terminálu.

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.

Optimalizace konfigurace paralelního pracovního procesu

Po hladkém spuštění testů se službou experimentujte s proměnlivým počtem paralelních pracovních procesů a určete optimální konfiguraci, která minimalizuje dobu dokončení testu.

S pracovními prostory Playwright můžete běžet až s 50 paralelními pracovními procesy. Několik faktorů ovlivňuje nejlepší konfiguraci vašeho projektu, například procesor, paměť a síťové prostředky vašeho klientského počítače, kapacitu zpracování zatížení cílové aplikace a typ akcí provedených v testech.

Můžete zadat počet paralelních pracovních procesů na příkazovém řádku Rozhraní příkazového řádku Playwright nebo nakonfigurovat workers vlastnost v konfiguračním souboru služby Playwright.

Můžete zadat počet paralelních pracovních procesů na příkazovém řádku rozhraní příkazového řádku Playwright nebo nakonfigurovat NumberOfTestWorkers vlastnost v .runsettings souboru.

Přečtěte si další informace o tom , jak určit optimální konfiguraci pro optimalizaci dokončení sady testů.

Další krok

Úspěšně jste vytvořili pracovní prostor Playwright na webu Azure Portal a spustili testy Playwright v cloudových prohlížečích.

Přejděte k dalšímu rychlému startu a nastavte průběžné kompletní testování spuštěním testů Playwright v pracovním postupu CI/CD.

Nastavení průběžného kompletního testování v CI/CD