Anteprima di Microsoft Playwright Testing

Microsoft Playwright Testing è un servizio di Azure completamente gestito che usa il cloud per consentire di eseguire test Playwright con parallelizzazione molto più elevata tra diverse combinazioni di browser del sistema operativo contemporaneamente. Ciò significa che le esecuzioni di test più veloci vengono eseguite con una copertura più ampia dello scenario, che consente di velocizzare la distribuzione delle funzionalità senza sacrificare la qualità. Il servizio consente anche di pubblicare i risultati dei test e gli artefatti correlati al servizio e visualizzarli nel portale del servizio, consentendo una risoluzione dei problemi più rapida e semplice. Con il servizio Microsoft Playwright Testing, è possibile rilasciare funzionalità in modo più rapido e sicuro.

Sei pronto per iniziare? Passare alla guida introduttiva !

Collegamenti utili

• Avvio rapido: Eseguire test end-to-end su larga scala
• Avvio rapido: Configurare test end-to-end continui in browser e sistemi operativi diversi
• Esplorare le funzionalità e i vantaggi
• documentazione
• prezzi
• Condividi commenti e suggerimenti

Introduzione

Seguire questa procedura per eseguire il gruppo di test Playwright esistente con il servizio.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
• All'account Azure deve essere assegnato ilproprietario , Collaboratoreo uno dei ruoli di amministratore classico .
• dell'interfaccia della riga di comando di Azure deve essere installato nel computer da cui si eseguono test Playwright.

Creare un'area di lavoro

1. Accedere al portale Playwright con l'account Azure.

2. Creare l'area di lavoro.

   

   Campo	Descrizione
   nome dell'area di lavoro	Nome univoco per identificare l'area di lavoro. Il nome non può contenere caratteri speciali o spazi vuoti.
   sottoscrizione di Azure	Selezionare una sottoscrizione di Azure in cui si vuole creare l'area di lavoro.
   'area	In questo caso, i dati di esecuzione dei test verranno archiviati per l'area di lavoro.

Se questa schermata non viene visualizzata, selezionare un'area di lavoro esistente e passare alla sezione successiva.

Installare il pacchetto Microsoft Playwright Testing

1. Eseguire questo comando per installare il pacchetto del servizio

   npm init @azure/microsoft-playwright-testing
   

L'installazione del pacchetto del servizio creerà un file di configurazione del servizio denominato playwright.service.config.ts

La configurazione del servizio serve a:

• Indirizzare ed autenticare Playwright nel servizio Microsoft Playwright Testing.
• Aggiungere la creazione di report di Microsoft Playwright Testing alla configurazione.
• Eseguire l'override dei timeout per le operazioni del servizio, se necessario.

Assicurarsi che il progetto usi @playwright/test versione 1.47 o successiva.

Ottenere l'endpoint dell'area

1. Nel portale playwright copiare il comando in Aggiungi endpoint area nelconfigurato.

   

   L'URL dell'endpoint corrisponde all'area dell'area di lavoro. È possibile che venga visualizzato un URL di endpoint diverso nel portale playwright, a seconda dell'area selezionata durante la creazione dell'area di lavoro.

Configurare l'ambiente

Assicurarsi che il PLAYWRIGHT_SERVICE_URL ottenuto nel passaggio precedente sia disponibile nell'ambiente.

È consigliabile usare dotenv modulo per gestire l'ambiente. Con dotenv si userà il file .env per definire le variabili di ambiente.

Non dimenticare di aggiungere .env file al file .gitignore per non perdere i segreti.

npm i --save-dev dotenv

.env file

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

Configurare l'autenticazione

Per eseguire i test Playwright nell'area di lavoro Microsoft Playwright Testing, è necessario autenticare il client Playwright in cui si eseguono i test con il servizio. Potrebbe trattarsi del computer di sviluppo locale o del computer ci.

Il servizio offre due metodi di autenticazione: Microsoft Entra ID e token di accesso.

Microsoft Entra ID usa le credenziali di Azure, che richiedono un accesso all'account Azure per l'accesso sicuro. In alternativa, è possibile generare un token di accesso dall'area di lavoro Playwright e usarlo nella configurazione.

Configurare l'autenticazione usando Microsoft Entra ID

Microsoft Entra ID è l'autenticazione predefinita e consigliata per il servizio. Dal computer di sviluppo locale è possibile usare dell'interfaccia della riga di comando di Azure per accedere

az login

NOTA: se si fa parte di più tenant di Microsoft Entra, assicurarsi di accedere al tenant a cui appartiene l'area di lavoro. È possibile ottenere l'ID tenant dal portale di Azure, vedere Trovare il tenant di Microsoft Entra. Dopo aver visualizzato l'ID, accedere usando il comando az login --tenant <TenantID>

Configurare l'autenticazione usando i token di accesso

È possibile generare un token di accesso dall'area di lavoro Playwright Testing e usarlo nella configurazione. Tuttavia, è consigliabile usare Microsoft Entra ID per l'autenticazione a causa della sicurezza avanzata. I token di accesso, mentre sono pratici, funzionano come password di lunga durata e sono più soggetti a essere compromessi.

1. Per usare l'autenticazione basata su token di accesso, Abilitare l'autenticazione basata su token di accesso

2. Configurare l'autenticazione usando i token di accesso

È consigliabile usare Microsoft Entra ID per l'autenticazione al servizio. Se si usano token di accesso, vedere Come gestire i token di accesso

NOTA: Per usare i test di Microsoft Playwright nelle pipeline CI, è necessario configurare l'autenticazione con il servizio dalla pipeline, vedere configurare test end-to-end continui in diversi browser e sistemi operativi

Eseguire i test

Eseguire test Playwright su browser gestiti dal servizio usando la configurazione creata in precedenza.

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

Passaggi successivi

• Eseguire test in una pipeline CI/CD .

• Informazioni su come gestire l'accesso all'area di lavoro creata.

• Sperimentare diversi ruoli di lavoro per determinare la configurazione ottimale del gruppo di test.

Contribuire

Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede l'accettazione di un Contratto di licenza collaboratore (CLA) che dichiara di avere il diritto e, in realtà, concedere a Microsoft i diritti per l'uso del contributo. Per informazioni dettagliate, visitare https://cla.opensource.microsoft.com.

Quando si invia una richiesta pull, un bot CLA determinerà automaticamente se è necessario fornire un contratto di licenza e decorare la richiesta pull in modo appropriato (ad esempio, controllo dello stato, commento). Seguire semplicemente le istruzioni fornite dal bot. Dovrai eseguire questa operazione una sola volta in tutti i repository usando la nostra cla.

Questo progetto ha adottato la codice di comportamento Microsoft Open Source. Per altre informazioni, vedere domande frequenti sul codice di comportamento o contattare opencode@microsoft.com con eventuali domande o commenti aggiuntivi.

Marchi

Questo progetto può contenere marchi o logo per progetti, prodotti o servizi. L'uso autorizzato dei marchi o dei logo Microsoft è soggetto a e deve seguire marchio microsoft & Brand Guidelines. L'uso di marchi o logo Microsoft nelle versioni modificate di questo progetto non deve causare confusione o implicare la sponsorizzazione Microsoft. Qualsiasi uso di marchi o logo di terze parti è soggetto alle politiche di tali terze parti.