Udostępnij za pośrednictwem

Microsoft Playwright Testing (wersja zapoznawcza)

  • Artykuł

Microsoft Playwright Testing to w pełni zarządzana usługa platformy Azure, która korzysta z chmury w celu umożliwienia jednoczesnego uruchamiania testów playwright z znacznie większą równoległacją w różnych kombinacjach przeglądarki systemu operacyjnego. Oznacza to szybsze przebiegi testów z szerszym zakresem scenariuszy, co pomaga przyspieszyć dostarczanie funkcji bez poświęcania jakości. Usługa umożliwia również publikowanie wyników testów i powiązanych artefaktów w usłudze oraz wyświetlanie ich w portalu usługi, co umożliwia szybsze i łatwiejsze rozwiązywanie problemów. Dzięki usłudze Microsoft Playwright Testing możesz szybciej i bezpieczniej wydać funkcje.

Chcesz rozpocząć pracę? Przejdź do naszego przewodnika Szybki start !

Rozpocząć

Wykonaj następujące kroki, aby uruchomić istniejący pakiet testowy Playwright z usługą.

Warunki wstępne

  • Konto platformy Azure z aktywną subskrypcją. Jeśli nie masz subskrypcji platformy Azure, utworzyć bezpłatne konto przed rozpoczęciem.
  • Twoje konto platformy Azure musi mieć przypisaną rolę właściciela , współautora lub jedną z ról administratora klasycznego .
  • interfejsu wiersza polecenia platformy Azure należy zainstalować na maszynie, z której są uruchamiane testy playwright.

Tworzenie obszaru roboczego

  1. Zaloguj się do portalu Playwright przy użyciu konta platformy Azure.

  2. Utwórz obszar roboczy.

    Tworzenie nowego obszaru roboczego

    Pole Opis
    nazwa obszaru roboczego Unikatowa nazwa identyfikująca obszar roboczy.
    Nazwa nie może zawierać znaków specjalnych ani białych znaków.
    subskrypcji platformy Azure Wybierz subskrypcję platformy Azure, w której chcesz utworzyć obszar roboczy.
    regionów W tym miejscu będą przechowywane dane przebiegu testu dla obszaru roboczego.

Jeśli ten ekran nie jest widoczny, wybierz istniejący obszar roboczy i przejdź do następnej sekcji.

Instalowanie pakietu Microsoft Playwright Testing

  1. Uruchom to polecenie, aby zainstalować pakiet usługi

    npm init @azure/microsoft-playwright-testing

Zainstalowanie pakietu usługi spowoduje utworzenie pliku konfiguracji usługi o nazwie playwright.service.config.ts

Konfiguracja usługi służy do:

  • Bezpośrednie i uwierzytelnianie Playwright w usłudze Microsoft Playwright Testing.
  • Dodaj raportowanie microsoft Playwright Testing do konfiguracji.
  • Zastąpić limity czasu dla operacji usługi, jeśli to konieczne.

Upewnij się, że projekt używa @playwright/test w wersji 1.47 lub nowszej.

Uzyskiwanie punktu końcowego regionu

  1. W portalu Playwrightskopiuj polecenie w obszarze Dodaj punkt końcowy regionu w konfiguracji.

    Ustawianie punktu końcowego obszaru roboczego

    Adres URL punktu końcowego odpowiada regionowi obszaru roboczego. W portalu Playwright może zostać wyświetlony inny adres URL punktu końcowego, w zależności od regionu wybranego podczas tworzenia obszaru roboczego.

Konfigurowanie środowiska

Upewnij się, że PLAYWRIGHT_SERVICE_URL uzyskane w poprzednim kroku są dostępne w danym środowisku.

Zalecamy używanie modułu dotenv do zarządzania środowiskiem. W przypadku dotenv użyjesz pliku .env do zdefiniowania zmiennych środowiskowych.

Nie zapomnij dodać .env pliku do pliku .gitignore, aby nie wyciekać wpisów tajnych.

npm i --save-dev dotenv

plik .env

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

Konfigurowanie uwierzytelniania

Aby uruchomić testy playwright w obszarze roboczym Microsoft Playwright Testing, należy uwierzytelnić klienta Playwright, w którym są uruchamiane testy z usługą. Może to być lokalna maszyna deweloperna lub maszyna ciągłej integracji.

Usługa oferuje dwie metody uwierzytelniania: Microsoft Entra ID i Tokeny dostępu.

Identyfikator Entra firmy Microsoft używa poświadczeń platformy Azure, co wymaga zalogowania się do konta platformy Azure w celu uzyskania bezpiecznego dostępu. Alternatywnie możesz wygenerować token dostępu z obszaru roboczego Playwright i użyć go w konfiguracji.

Konfigurowanie uwierzytelniania przy użyciu identyfikatora Entra firmy Microsoft

Identyfikator Entra firmy Microsoft jest domyślnym i zalecanym uwierzytelnianiem dla usługi. Z poziomu lokalnej maszyny deweloperów możesz użyć interfejsu wiersza polecenia platformy Azure do logowania

az login

UWAGA: jeśli jesteś częścią wielu dzierżaw firmy Microsoft Entra, upewnij się, że logujesz się do dzierżawy, do której należy obszar roboczy. Identyfikator dzierżawy można uzyskać w witrynie Azure Portal, zobacz Find your Microsoft Entra Tenant. Po otrzymaniu identyfikatora zaloguj się przy użyciu polecenia az login --tenant <TenantID>

Konfigurowanie uwierzytelniania przy użyciu tokenów dostępu

Możesz wygenerować token dostępu z obszaru roboczego Testowanie dramaturgu i użyć go w konfiguracji. Zdecydowanie zalecamy jednak używanie identyfikatora Entra firmy Microsoft do uwierzytelniania ze względu na jego zwiększone zabezpieczenia. Tokeny dostępu, choć wygodne, działają jak hasła długotrwałe i są bardziej podatne na naruszenie zabezpieczeń.

  1. Aby użyć uwierzytelniania opartego na tokenach dostępu, włączanie uwierzytelniania opartego na tokenach dostępu

  2. Konfigurowanie uwierzytelniania przy użyciu tokenów dostępu

Zdecydowanie zalecamy używanie identyfikatora Entra firmy Microsoft do uwierzytelniania w usłudze. Jeśli używasz tokenów dostępu, zobacz Jak zarządzać tokenami dostępu

UWAGA: Aby korzystać z testowania dramaturgowego firmy Microsoft w potokach ciągłej integracji, należy skonfigurować uwierzytelnianie za pomocą usługi z potoku, zobacz skonfigurować ciągłe kompleksowe testowanie w różnych przeglądarkach i systemach operacyjnych

Uruchamianie testów

Uruchom testy playwright dla przeglądarek zarządzanych przez usługę przy użyciu utworzonej powyżej konfiguracji.

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

Następne kroki

Przyczyniając się

Ten projekt z zadowoleniem przyjmuje wkład i sugestie. Większość kontrybucja wymaga zgody na umowę licencyjną współautora (CLA), deklarując, że masz prawo, a w rzeczywistości przyznaj nam prawa do korzystania z twojego wkładu. Aby uzyskać szczegółowe informacje, odwiedź stronę https://cla.opensource.microsoft.com.

Po przesłaniu żądania ściągnięcia bot CLA automatycznie określi, czy musisz podać cla i odpowiednio ozdobić żądanie ściągnięcia (np. sprawdzanie stanu, komentarz). Po prostu postępuj zgodnie z instrukcjami dostarczonymi przez bota. Należy to zrobić tylko raz we wszystkich repozytoriach przy użyciu naszego CLA.

Ten projekt przyjął kodeks postępowania firmy Microsoft typu open source. Aby uzyskać więcej informacji, zobacz Kodeks postępowania — często zadawane pytania lub skontaktuj się z opencode@microsoft.com z dodatkowymi pytaniami lub komentarzami.

Znakami towarowymi

Ten projekt może zawierać znaki towarowe lub logo projektów, produktów lub usług. Autoryzowane używanie znaków towarowych lub logo firmy Microsoft podlega i musi przestrzegać wytycznych dotyczących znaków towarowych firmy Microsoft & markowych. Używanie znaków towarowych lub logo firmy Microsoft w zmodyfikowanych wersjach tego projektu nie może powodować nieporozumień ani sugerować dostępu sponsorowanego przez firmę Microsoft. Wszelkie zastosowania znaków towarowych lub logo innych firm podlegają zasadom tych firm.