Rychlý start: Spuštění komplexních testů ve velkém měřítku pomocí microsoft Playwright Testing Preview

V tomto rychlém startu se dozvíte, jak spouštět testy Playwright s vysoce paralelními cloudovými prohlížeči a snadno řešit potíže s neúspěšnými testy pomocí microsoft Playwright Testing Preview. Použijte cloudovou infrastrukturu k ověření aplikace v různých prohlížečích, zařízeních a operačních systémech. Publikujte výsledky a artefakty vygenerované playwrightem do služby a zobrazte je na portálu služby.

Po dokončení tohoto rychlého startu máte pracovní prostor Microsoft Playwright Testing ke spuštění testů Playwright ve velkém měřítku a zobrazení výsledků testů a artefaktů na portálu služby.

Důležité

Microsoft Playwright Testing je aktuálně ve verzi Preview. Právní podmínky, které se vztahují na funkce Azure, které jsou ve verzi beta, ve verzi Preview nebo které ještě nejsou vydány v obecné dostupnosti, najdete v dodatečných podmínkách použití pro verze Microsoft Azure Preview.

Požadavky

• Účet Azure s aktivním předplatným. Pokud ještě nemáte předplatné Azure, vytvořte si napřed bezplatný účet.
• 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 Microsoft Playwright Testing.
• Rozhraní příkazového řádku Azure. 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 ve velkém měřítku v cloudových prohlížečích, nejprve vytvoříte pracovní prostor Microsoft Playwright Testing na portálu Playwright.

1. Přihlaste se k portálu Playwright pomocí svého účtu Azure.

2. Pokud už pracovní prostor máte, vyberte existující pracovní prostor a přejděte k dalšímu kroku.

   Tip

   Pokud máte více pracovních prostorů, můžete přepnout do jiného pracovního prostoru tak, že v horní části stránky vyberete název pracovního prostoru a pak vyberete Spravovat všechny pracovní prostory.

3. Pokud ještě pracovní prostor nemáte, vyberte + Nový pracovní prostor a zadejte následující informace:

   Pole	Popis
   Název pracovního prostoru	Zadejte jedinečný název pro identifikaci pracovního prostoru. Název se může skládat pouze z alfanumerických znaků a má délku mezi 3 a 64 znaky.
   Předplatné Azure	Vyberte předplatné Azure, které chcete použít pro tento pracovní prostor Microsoft Playwright Testing.
   Oblast	Vyberte zeměpisné umístění pro hostování vašeho pracovního prostoru. Toto je umístění, kde jsou data testovacího spuštění uložená pro pracovní prostor.

   

4. Výběrem možnosti Vytvořit pracovní prostor vytvořte pracovní prostor ve vašem předplatném.

   Během vytváření pracovního prostoru se ve vašem předplatném Azure vytvoří nová skupina prostředků a prostředek Microsoft Playwright Testing Azure.

Po dokončení vytváření pracovního prostoru budete přesměrováni do průvodce nastavením.

Instalace balíčku Microsoft Playwright Testing

Chcete-li použít službu, nainstalujte balíček Microsoft Playwright Testing.

npm init @azure/microsoft-playwright-testing

Tím se vygeneruje playwright.service.config.ts soubor, který slouží k:

• Direct and authenticate Playwright to the Microsoft Playwright Testing service.
• Přidá reportér pro publikování výsledků testu a artefaktů.

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

Konfigurace koncového bodu oblasti služby

V nastavení musíte zadat koncový bod služby 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 služby, proveďte následující kroky:

1. V části Přidat koncový bod oblasti v nastavení zkopírujte koncový bod oblasti pro váš pracovní prostor.

   Adresa URL koncového bodu odpovídá oblasti Azure, kterou jste vybrali při vytváření pracovního prostoru.

   

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. 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í ověřování

Pokud chcete spustit testy Playwright v pracovním prostoru Microsoft Playwright Testing, 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í dvě metody ověřování: Microsoft Entra ID a přístupové tokeny.

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 Testing a použít ho v nastavení. Kvůli rozšířenému zabezpečení však důrazně doporučujeme microsoft Entra ID pro ověřování. Přístupové tokeny, zatímco pohodlné, fungují jako dlouhodobá hesla a jsou náchylnější k ohrožení zabezpečení.

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

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

Upozornění

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

Povolení artefaktů v konfiguraci Playwright

playwright.config.ts V souboru projektu se ujistěte, že shromažďujete všechny požadované artefakty.

  use: {
    trace: 'on-first-retry',
    video:'retain-on-failure',
    screenshot:'on'
  }

Spouštění testů ve velkém měřítku pomocí microsoft Playwright Testing

Teď jste připravili konfiguraci pro spouštění testů Playwright v cloudu pomocí microsoft Playwright Testing. 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 ve velkém měřítku

Microsoft Playwright Testing vám bude účtován na základě celkového počtu minut testu a počtu publikovaných výsledků testů. Pokud jste uživatelem poprvé nebo začínáte s bezplatnou zkušební verzí, můžete začít s spuštěním jednoho testu ve velkém měřítku místo plné testovací sady, abyste se vyhnuli vyčerpání bezplatných zkušebních limitů.

Poznámka:

Funkce vytváření sestav je ve výchozím nastavení povolená pro existující pracovní prostory. Tato akce se zavádí ve fázích a bude trvat několik dní. Abyste se vyhnuli chybám, před pokračováním ověřte, že Rich diagnostics using reporting je pro váš pracovní prostor zapnuté nastavení. Viz povolení vytváření sestav pro pracovní prostor.

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 pomocí microsoft Playwright Testing:

Playwright CLI

Pokud chcete použít playwright CLI ke spuštění testů pomocí microsoft Playwright Testing, 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 microsoft Playwright Testing, 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 ve velkém měřítku

Teď, když jste ověřili, že můžete spustit jeden test pomocí microsoft Playwright Testing, 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 pomocí microsoft Playwright Testing:

Playwright CLI

Když spustíte více testů Playwright nebo úplnou sadu testů pomocí microsoft Playwright Testing, 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)
   
   Test report: https://playwright.microsoft.com/workspaces/<workspace-id>/runs/<run-id>
   

Visual Studio Code

Spuštění sady testů Playwright v editoru Visual Studio Code pomocí microsoft Playwright Testing:

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

2. Vyberte tlačítko Spustit testy a spusťte všechny testy pomocí nástroje Microsoft Playwright Testing.

   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 .

Zobrazení testovacích spuštění a výsledků na portálu Playwright

Nyní můžete řešit potíže s neúspěšnými testovacími případy na portálu Playwright.

1. Po dokončení testovacího spuštění se vygeneruje odkaz na portál Playwright. Otevřením tohoto odkazu zobrazíte podrobné výsledky testů a přidružené artefakty. Portál zobrazuje základní informace, mezi které patří:

   • Podrobnosti o sestavení CI
   • Celkový stav testovacího spuštění
   • ID potvrzení propojené s testovacím spuštěním

   

2. Portál Playwright poskytuje všechny potřebné informace pro řešení potíží. Můžete provádět následující akce:

   • Přepínání mezi opakovanými pokusy
   • Prohlédněte si podrobné protokoly chyb, testovací kroky a připojené artefakty, jako jsou snímky obrazovky nebo videa.
   • Pokud chcete provést hlubší analýzu, přejděte přímo do prohlížeče trasování.

   

3. Prohlížeč trasování umožňuje vizuálně procházet provádění testů. Můžete provádět následující akce:

   • Časovou osu použijte k najetí myší na jednotlivé kroky a zobrazte stav stránky před a po každé akci.
   • Pro každý krok zkontrolujte podrobné protokoly, snímky DOM, síťovou aktivitu, chyby a výstup konzoly.

   

Tip

Funkce služby Microsoft Playwright Testing můžete používat nezávisle na sobě. Výsledky testů můžete publikovat na portálu bez použití funkce prohlížečů hostovaných v cloudu. K urychlení sady testů bez publikování výsledků testů můžete použít jenom prohlížeče hostované v cloudu.

Poznámka:

Výsledky testu a artefakty, které publikujete, se zachovají ve službě po dobu 90 dnů. Potom se automaticky odstraní.

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.

Microsoft Playwright Testing umožňuje spustit až 50 paralelních pracovních procesů. 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.

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 Microsoft Playwright Testing na portálu Playwright 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