Pré-visualização do Teste de Playwright da Microsoft

Artigo
12/21/2024

O Microsoft Playwright Testing é um serviço do Azure totalmente gerenciado que usa a nuvem para permitir que você execute testes de Playwright com paralelização muito maior em diferentes combinações de sistema operacional e navegador simultaneamente. Isso significa execuções de teste mais rápidas com uma cobertura de cenário mais ampla, o que ajuda a acelerar a entrega de recursos sem sacrificar a qualidade. O serviço também permite que você publique resultados de teste e artefatos relacionados ao serviço e visualize-os no portal de serviço, permitindo uma solução de problemas mais rápida e fácil. Com o serviço Microsoft Playwright Testing, você pode liberar recursos com mais rapidez e confiança.

Pronto para começar? Salte para o nosso guia de início rápido !

Ligações úteis

Começar

Siga estas etapas para executar seu pacote de teste Playwright existente com o serviço.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Sua conta do Azure deve receber o Proprietário, de Colaborador ou uma das funções clássicas de administrador.
da CLI do Azure deve ser instalada na máquina de onde você está executando testes de Playwright.

Criar um espaço de trabalho

Entre no portal do Playwright com sua conta do Azure.

Crie o espaço de trabalho.

Criar novo espaço de trabalho

Domínio	Descrição
Nome do espaço de trabalho	Um nome exclusivo para identificar seu espaço de trabalho. O nome não pode conter caracteres especiais ou espaços em branco.
de Subscrição do Azure	Selecione uma assinatura do Azure onde você deseja criar o espaço de trabalho.
Região	É aqui que os dados de execução de teste serão armazenados para o seu espaço de trabalho.

Se não vir este ecrã, selecione uma área de trabalho existente e vá para a secção seguinte.

Instalar o pacote Microsoft Playwright Testing

Execute este comando para instalar o pacote de serviço
```
npm init @azure/microsoft-playwright-testing
```

A instalação do pacote de serviço criará um arquivo de configuração de serviço chamado playwright.service.config.ts

A configuração do serviço serve para:

Direcione e autentique o Playwright para o serviço Microsoft Playwright Testing.
Adicione o relatório Microsoft Playwright Testing à sua configuração.
Substitua os tempos limite para operações de serviço, se necessário.

Certifique-se de que o seu projeto utiliza @playwright/test versão 1.47 ou superior.

Obter ponto de extremidade de região

No portal Playwright, copie o comando em Adicionar ponto de extremidade de região em sua configuração.

A URL do ponto de extremidade corresponde à região do espaço de trabalho. Você pode ver uma URL de ponto de extremidade diferente no portal Playwright, dependendo da região selecionada ao criar o espaço de trabalho.

Configurar ambiente

Certifique-se de que o PLAYWRIGHT_SERVICE_URL obtido na etapa anterior esteja disponível em seu ambiente.

Recomendamos o uso dotenv módulo para gerenciar seu ambiente. Com dotenv você usará o arquivo .env para definir suas variáveis de ambiente.

Não se esqueça de adicionar .env arquivo ao seu arquivo .gitignore para não vazar seus segredos.

npm i --save-dev dotenv

.env arquivo

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

Configurar autenticação

Para executar os testes do Playwright no espaço de trabalho Microsoft Playwright Testing, você precisa autenticar o cliente Playwright onde você está executando os testes com o serviço. Esta pode ser a sua máquina de desenvolvimento local ou máquina de CI.

O serviço oferece dois métodos de autenticação: ID do Microsoft Entra e Tokens de Acesso.

O Microsoft Entra ID usa suas credenciais do Azure, exigindo uma entrada em sua conta do Azure para acesso seguro. Como alternativa, você pode gerar um token de acesso a partir do seu espaço de trabalho Playwright e usá-lo em sua configuração.

Configurar a autenticação usando o Microsoft Entra ID

Microsoft Entra ID é a autenticação padrão e recomendada para o serviço. Em sua máquina de desenvolvimento local, você pode usar da CLI do Azure para entrar

az login

NOTA: Se fizer parte de vários inquilinos do Microsoft Entra, certifique-se de que inicia sessão no inquilino a que pertence a sua área de trabalho. Pode obter o ID do inquilino a partir do portal do Azure, consulte Localizar o seude Inquilino do Microsoft Entra . Depois de obter o ID, entre usando o comando az login --tenant <TenantID>

Configurar a autenticação usando tokens de acesso

Você pode gerar um token de acesso a partir do espaço de trabalho Teste de Playwright e usá-lo em sua configuração. No entanto, recomendamos vivamente o Microsoft Entra ID para autenticação devido à sua segurança melhorada. Os tokens de acesso, embora convenientes, funcionam como senhas de longa duração e são mais suscetíveis a serem comprometidos.

Para usar a autenticação baseada em token de acesso, Habilitar autenticação baseada em token de acesso
Configurar a autenticação usando tokens de acesso

É altamente recomendável usar o Microsoft Entra ID para autenticação no serviço. Se você estiver usando tokens de acesso, consulte Como gerenciar tokens de acesso

NOTA: Para usar o Microsoft Playwright Testing em pipelines de CI, você precisa configurar a autenticação com o serviço do pipeline, consulte configurar testes contínuos de ponta a ponta em diferentes navegadores e sistemas operacionais

Executar os testes

Execute testes de Playwright em navegadores gerenciados pelo serviço usando a configuração que você criou acima.

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

Próximos passos

Execute testes em um pipeline de CI/CD .
Saiba como gerenciar o acesso ao espaço de trabalho criado.
Experimente com diferentes números de trabalhadores para determinar a configuração ideal do seu conjunto de testes.

Contribuição

Este projeto acolhe contribuições e sugestões. A maioria das contribuições exige que você concorde com um Contrato de Licença de Colaborador (CLA) declarando que você tem o direito de, e realmente concede, os direitos de usar sua contribuição. Para mais detalhes, visite https://cla.opensource.microsoft.com.

Quando você envia uma solicitação pull, um bot CLA determinará automaticamente se você precisa fornecer um CLA e decorar o PR adequadamente (por exemplo, verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios usando nosso CLA.

Este projeto adotou o Microsoft Open Source Code of Conduct. Para obter mais informações, consulte o de perguntas frequentes sobre o Código de Conduta ou entre em contato com para obter perguntas ou comentários adicionais.

Marcas comerciais

Este projeto pode conter marcas comerciais ou logotipos para projetos, produtos ou serviços. O uso autorizado de marcas comerciais ou logotipos da Microsoft está sujeito e deve seguir Diretrizes de Marcas Comerciais & Marcas da Microsoft. O uso de marcas comerciais ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio da Microsoft. Qualquer uso de marcas comerciais ou logotipos de terceiros está sujeito às políticas desses terceiros.

Partilhar via