Azure Playwright

Azure Playwright je plně spravovaná služba Azure, která využívá cloud k tomu, aby vám umožnila spouštět testy Playwright s mnohem vyšší paralelizací napříč různými kombinacemi operačního systému a prohlížeče současně. To znamená rychlejší testovací běhy s širším pokrytím scénářů, což pomáhá urychlit doručování funkcí bez obětování kvality. Služba také zahrnuje integrované reportovací funkce, které automaticky nahrávají testovací výsledky a související artefakty do Azure úložiště a zobrazují je v servisním portálu, což umožňuje rychlejší a jednodušší řešení problémů. S Playwright Workspaces můžete zveřejňovat funkce rychleji a sebevědoměji.

Jste připravení začít? Skočte do našeho průvodce rychlým startem!

Užitečné odkazy

Začínáme

Pomocí těchto kroků spustíte stávající testovací sadu Playwright se službou.

Požadavky

Účet Azure s aktivním předplatným. Pokud nemáte předplatné Azure, si před zahájením vytvořit bezplatný účet.
Vašemu účtu Azure musí být přiřazena role vlastníka, přispěvatele nebo jedné z rolí klasického správce.
Azure CLI musí být nainstalované v počítači, ze kterého spouštíte testy Playwright.

Vytvoření pracovní plochy

Přihlaste se k webu Azure Portal pomocí svého účtu Azure.

Vytvořte pracovní prostor.

Vyberte tlačítko nabídky v levém horním rohu portálu a poté vyberte možnost Vytvořit prostředek.
Do vyhledávacího pole zadejte Playwright Workspaces .
Vyberte kartu Pracovní prostory dramatika a poté vyberte možnost Vytvořit.

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

Obor	Description
Subscription	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 pouze z alfanumerických znaků a může mít délku mezi 3 a 64 znaky.
Location	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.
Podávání zpráv	Ve výchozím nastavení je přepínač "Povoleno", aby uživatelé mohli ukládat a zobrazovat své testovací zprávy z Playwright Workspace. Pokud chcete vypnout hlášení, přepněte nastavení na "Zakázáno".
Účet úložiště	Nový úložný účet je vytvořen a vybrán ve výchozím nastavení pro ukládání artefaktů hlášených Playwright Workspaces. Pro výběr stávajícího úložného účtu vyberte z rozbalovacího menu nebo klikněte na "Vytvořit nový" a vytvořte si nový úložný účet dle vlastního výběru.

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ů.

Po dokončení konfigurace prostředku vyberte Zkontrolovat a vytvořit.
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í.
Pokud chcete zobrazit nový pracovní prostor, vyberte Přejít k prostředku.

Instalace balíčku Azure Playwright

Spuštěním tohoto příkazu nainstalujte balíček služby
```
npm init @azure/playwright@latest
```

Instalací balíčku služby se vytvoří konfigurační soubor služby s názvem playwright.service.config.ts

Konfigurace služby slouží k:

Směrovat a ověřovat dramatika na pracovní prostory dramatika.
Přidejte Playwright Workspaces reportující do své konfigurace.
V případě potřeby přepište časové limity pro operace služby.

Ujistěte se, že váš projekt používá @playwright/test verzi 1.47 nebo vyšší.

Získání koncového bodu oblasti

Na webu Azure Portal zkopírujte příkaz do části Přidat koncový bod oblasti ve svém nastavení.

Adresa URL koncového bodu odpovídá oblasti pracovního prostoru. V Azure Portal se může zobrazit jiná adresa URL koncového bodu v závislosti na oblasti, kterou jste vybrali při vytváření pracovního prostoru.

Nastavení prostředí

Ujistěte se, že to PLAYWRIGHT_SERVICE_URL , co jste získali v předchozím kroku, je dostupné ve vašem prostředí.

Pro správu prostředí doporučujeme použít dotenv modul. S dotenv budete používat soubor .env k definování proměnných prostředí.

Nezapomeňte přidat .env soubor do svého .gitignore souboru, aby nedošlo k úniku vašich tajemství.

npm i --save-dev dotenv

Soubor .env

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

Nastavení ověřování

Chcete-li spustit testy Playwright v pracovním prostoru Azure Playwright, musíte ověřit klienta Playwright, ve kterém testy se službou spouštíte. 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í autentizace 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 klientů Microsoft Entra, ujistěte se, že se přihlašujete k klientovi, do kterého patří váš pracovní prostor. ID tenanta můžete získat z 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 Azure 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.

Chcete-li použít ověřování na základě přístupového tokenu, povolte ověřování na základě přístupových tokenů.
Nastavení ověřování pomocí přístupových tokenů

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 článek Správa přístupových tokenů

POZNÁMKA: Pokud chcete používat Azure Playwright v kanálech CI, musíte nakonfigurovat ověřování pomocí služby z kanálu, viz Nastavení průběžného kompletního testování v různých prohlížečích a operačních systémech.

Spuštění testů

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

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

Azure Playwright Reporter

Azure Playwright obsahuje vlastní reportér, který automaticky nahrává vaše Playwright HTML testovací zprávy do Azure Storage, což je činí přístupnými přímo přes Azure portál pro snadnější ladění a sdílení výsledků.

Features

Automatické nahrávání reportů: Bezproblémově nahrává HTML zprávy Playwright do vašeho účtu Azure Storage
Integrace s portálem: Zobrazit výsledky testů přímo v portálu Azure Playwright
Vylepšené ladění: Přístup k detailním testovacím artefaktům, stopám a screenshotům

Nastavení a konfigurace

Součástí balíčku @azure/playwright je reportér Azure Playwright a pracuje vedle vestavěného HTML reportéra Playwright.

1. Konfigurujte reportéry v konfiguraci Playwright

Přidejte HTML reportéra i Azure Playwright reportéra do svých playwright.service.config.ts:

import { getServiceConfig, PlaywrightReporter } from "@azure/playwright";
import { defineConfig } from "@playwright/test";
import { DefaultAzureCredential } from "@azure/identity";

// <snippet_configure_reporters>
import { getServiceConfig, PlaywrightReporter } from "@azure/playwright";
import { defineConfig } from "@playwright/test";
import { DefaultAzureCredential } from "@azure/identity";
export default defineConfig(
  getServiceConfig({
    // Your existing configuration
    credential: new DefaultAzureCredential(),
  }),
  {
    reporter: [
      ["html", { open: "never" }], // HTML reporter must come first
      ["@azure/playwright/reporter"], // Azure reporter uploads HTML report
    ],
  },
);

2. Předpoklady pro hlášení

Před použitím Azure Playwright Reporter se ujistěte, že máte správně nastavený pracovní prostor:

Konfigurace pracovního prostoru

Povolte reportování a nastavte úložiště:

Přejděte do svého Playwright Workspace v Azure portálu
Přejděte na záložku Konfigurace úložiště
Přepínač hlášení na povoleno
Vytvořte nový nebo vyberte stávající úložný účet
Klikněte na Uložit.

Konfigurujte RBAC pro přístup k úložiští:

Otevřete účet propojeného úložiště
Přejděte na záložku Řízení přístupu (IAM)
Klikněte na Přidat přiřazení role
Vyhledejte a vyberte roli Storage Blob Data Contributor , poté klikněte na Další
Vyberte a přidejte všechny členy, kteří budou testy provádět
Klikněte na Recenzovat + přiřadit

Konfigurujte CORS pro Trace Viewer:

Otevřete účet propojeného úložiště
Přejděte do Nastavení → Sdílení zdrojů (CORS)
Pod službou Blob přidejte nový rekord:
- Povolené původy: https://trace.playwright.dev
- Povolené metody: GET, OPTIONS
- Maximální věk: Zadejte hodnotu mezi 0 a 2147483647
Klikněte na Uložit.

Požadavky klienta

Autentizace: Je vyžadována autentizace Microsoft Entra ID (přístupové tokeny nejsou podporovány pro reportování)
Verze pro Playwright: Vyžaduje verzi Playwright 1.57 nebo vyšší
Konfigurace služby: Musí použít konfiguraci služby (playwright.service.config.ts)
Nastavení pracovního prostoru: Reportování musí být povoleno ve vašem pracovním prostoru Azure Playwright

Jak to funguje

Test Execution: Testy běží normálně pomocí prohlížečů služeb Azure Playwright
Generování HTML zpráv: HTML reportér Playwrighta generuje standardní testovací zprávu
Automatické nahrávání: Azure Reporter nahraje složku HTML reportů do Azure Storage vašeho pracovního prostoru
Přístup k portálu: Zobrazit výsledky v Azure portálu přes zadanou URL adresu

Další kroky

Spusťte testy v kanálu CI/CD.
Naučte se spravovat přístup k vytvořenému pracovnímu prostoru.
Experimentujte s různým počtem pracovních procesů, abyste určili optimální konfiguraci testovací sady.

Contributing

Tento projekt vítá příspěvky a podněty. Většina příspěvků vyžaduje, abyste souhlasili s licenční smlouvou pro přispěvatele (CLA), která prohlašuje, že máte právo nám udělit práva k použití vašeho příspěvku a skutečně je udělujete. Podrobnosti najdete na adrese https://cla.opensource.microsoft.com.

Když odešlete žádost o přijetí změn, robot CLA automaticky určí, zda je třeba poskytnout smlouvu CLA, a vhodně ozdobí žádost o přijetí změn (např. kontrola stavu, komentář). Jednoduše postupujte podle pokynů robota. Budete to muset udělat pouze jednou ve všech úložištích pomocí našeho programu CLA.

Tento projekt přijal Kodex chování Microsoft Open Source. Další informace naleznete v nejčastějších dotazech ke kodexu chování nebo nás kontaktujte opencode@microsoft.com s dalšími dotazy či připomínkami.

Ochranné známky

Tento projekt může obsahovat ochranné známky nebo loga pro projekty, produkty nebo služby. Autorizované použití ochranných známek nebo log společnosti Microsoft podléhá Pravidlům společnosti Microsoft pro ochranné známky a značky a musí se jimi řídit. Použití ochranných známek nebo log společnosti Microsoft v upravených verzích tohoto projektu nesmí způsobovat záměnu ani naznačovat sponzorství společnosti Microsoft. Jakékoli použití ochranných známek nebo log třetích stran podléhá zásadám těchto třetích stran.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-01-28