Sdílet prostřednictvím


Microsoft Playwright Testing Preview

Microsoft Playwright Testing je plně spravovaná služba Azure, která používá cloud, abyste mohli spouštět testy Playwright s mnohem vyšší paralelizací napříč různými kombinacemi prohlížeče operačního systému 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é umožňuje publikovat výsledky testů a související artefakty do služby a zobrazit je na portálu služby, což umožňuje rychlejší a jednodušší řešení potíží. Díky službě Microsoft Playwright Testing můžete vydávat funkce rychleji a s jistotou.

Jste připravení začít? Přejděte do naší příručky pro rychlý start !

Rozjet

Pomocí těchto kroků spusť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.
  • Váš účet Azure musí být přiřazenývlastníka , přispěvatelenebo některé z klasických rolí správce.
  • Azure CLI musí být nainstalované na počítači, ze kterého spouštíte testy Playwright.

Vytvoření pracovního prostoru

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

  2. Vytvořte pracovní prostor.

    Vytvoření nového pracovního prostoru

    Pole Popis
    název pracovního prostoru Jedinečný název pro identifikaci pracovního prostoru
    Název nemůže obsahovat speciální znaky ani prázdné znaky.
    předplatného Azure Vyberte předplatné Azure, ve kterém chcete pracovní prostor vytvořit.
    oblasti Tady se ukládají data testovacího spuštění pro váš pracovní prostor.

Pokud tuto obrazovku nevidíte, vyberte existující pracovní prostor a přejděte k další části.

Instalace balíčku Microsoft Playwright Testing

  1. Spuštěním tohoto příkazu nainstalujte balíček služby.

    npm init @azure/microsoft-playwright-testing
    

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

Konfigurace služby slouží k:

  • Direct and authenticate Playwright to the Microsoft Playwright Testing service.
  • Přidejte do konfigurace sestavy Microsoft Playwright Testing.
  • V případě potřeby přepište časové limity pro operace služby.

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

Získání koncového bodu oblasti

  1. Na portálu Playwrightzkopírujte příkaz v části Přidat koncový bod oblasti v nastaveném.

    Nastavení koncového bodu pracovního prostoru

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

Nastavení prostředí

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

Ke správě prostředí doporučujeme použít modul dotenv. S dotenv použijete soubor .env k definování proměnných prostředí.

Nezapomeňte do souboru .gitignore přidat .env soubor, aby nedošlo k úniku tajných kódů.

npm i --save-dev dotenv

.env soubor

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

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í ID Microsoft Entra

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řihlašujete 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. Pokud chcete použít ověřování na základě přístupového tokenu, Povolit ověřování na základě přístupového tokenu

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

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ů

POZNÁMKA: Chcete-li používat microsoft Playwright Testing v kanálech CI, musíte nakonfigurovat ověřování se službou 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

Další kroky

Přispívající

Tento projekt vítá příspěvky a návrhy. Většina příspěvků vyžaduje souhlas s licenční smlouvou s přispěvatelem (CLA), která deklaruje, že máte právo a ve skutečnosti nám udělíte práva k používání vašeho příspěvku. Podrobnosti najdete v https://cla.opensource.microsoft.com.

Když odešlete žádost o přijetí změn, robot CLA automaticky určí, jestli potřebujete poskytnout CLA a odpovídajícím způsobem vyzdobit žádost o přijetí změn (např. kontrolu stavu, komentář). Stačí postupovat podle pokynů poskytovaných robotem. Stačí to udělat jen jednou napříč všemi úložištěmi pomocí naší cla.

Tento projekt přijal pravidla chování microsoftu open source . Další informace najdete v nejčastějších dotazech k kodexu chování nebo kontaktujte opencode@microsoft.com s dalšími dotazy nebo komentáři.

Ochranné známky

Tento projekt může obsahovat ochranné známky nebo loga pro projekty, produkty nebo služby. Autorizované používání ochranných známek nebo log společnosti Microsoft podléhá ochranným známkám společnosti Microsoft a musí dodržovat ochranné známky společnosti Microsoft & pokyny pro značky. Použití ochranných známek nebo log Společnosti Microsoft v upravených verzích tohoto projektu nesmí způsobit nejasnosti nebo znamenat, že microsoft sponsorship. Jakékoli použití ochranných známek nebo log třetích stran podléhá zásadám třetích stran.