Versão prévia do Microsoft Playwright Testing

O Microsoft Playwright Testing é um serviço do Azure totalmente gerenciado que usa a nuvem para permitir que você execute testes do Dramaturgo com paralelização muito maior em diferentes combinações de navegador do sistema operacional 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 os exiba 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 lançar recursos com mais rapidez e confiança.

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

Links úteis

• início rápido : executar testes de ponta a ponta em escala
• Início Rápido: Configurar testes contínuos de ponta a ponta em diferentes navegadores e sistemas operacionais
• Explorar recursos e benefícios
• documentação do
• de preços do
• Compartilhar comentários

Começar

Siga estas etapas para executar o conjunto de testes do Dramaturgo existente com o serviço.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, criar uma conta gratuita antes de começar.
• Sua conta do Azure deve receber o Owner, Contributorou uma das funções de administrador clássicas .
• CLI do Azure deve ser instalada no computador de onde você está executando testes do Dramaturgo.

Criar um workspace

1. Entre no portal do Dramaturgo com sua conta do Azure.

2. Crie o Workspace.

   

   Campo	Descrição
   de Nome do Workspace	Um nome exclusivo para identificar seu workspace. O nome não pode conter caracteres especiais ou espaço em branco.
   assinatura do Azure	Selecione uma assinatura do Azure na qual você deseja criar o workspace.
   da Região	É aí que os dados de execução de teste serão armazenados para seu workspace.

Se você não vir essa tela, selecione um workspace existente e vá para a próxima seção.

Instalar o pacote de Testes do Microsoft Playwright

1. 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 Dramaturgo para o serviço Microsoft Playwright Testing.
• Adicione relatórios do Microsoft Playwright Testing à sua configuração.
• Substitua tempos limite para operações de serviço, se necessário.

Verifique se o projeto usa @playwright/test versão 1.47 ou superior.

Obter ponto de extremidade de região

1. No portal do Playwright, copie o comando em Adicionar ponto de extremidade de região em seuconfigurado.

   de ponto de extremidade do workspace

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

Configurar o ambiente

Verifique se o PLAYWRIGHT_SERVICE_URL obtido na etapa anterior está disponível em seu ambiente.

É recomendável usar 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 arquivo .gitignore para não vazar seus segredos.

npm i --save-dev dotenv

arquivo .env

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

Configurar a Autenticação

Para executar seus testes de Dramaturgo em seu workspace do Microsoft Playwright Testing, você precisa autenticar o cliente dramaturgo no qual você está executando os testes com o serviço. Pode ser seu computador de desenvolvimento local ou computador CI.

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

A ID do Microsoft Entra 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 do workspace do Dramaturgo e usá-lo em sua configuração.

Configurar a autenticação usando a ID do Microsoft Entra

A ID do Microsoft Entra é a autenticação padrão e recomendada para o serviço. No computador de desenvolvimento local, você pode usar CLI do Azure para entrar

az login

OBSERVAÇÃO: se você fizer parte de vários locatários do Microsoft Entra, certifique-se de entrar no locatário onde o workspace pertence. Você pode obter a ID do locatário no portal do Azure, consulte Localizar seu locatário do Microsoft Entra. Depois de obter a ID, entre usando o comando az login --tenant <TenantID>

Configurar a autenticação usando tokens de acesso

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

1. Para usar a autenticação baseada em token de acesso, habilitar a autenticação baseada em token de acesso

2. Configurar a autenticação usando tokens de acesso

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

OBSERVAÇÃO: 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 de ponta a ponta contínuos em diferentes navegadores e sistemas operacionais

Executar os testes

Execute testes do Dramaturgo 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óximas etapas

• Execute testes em um pipeline de CI/CD .

• Saiba como gerenciar o acesso ao workspace criado.

• Experimente um número diferente de trabalhos para determinar a configuração ideal do conjunto de testes.

Contribuindo

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

Quando você envia uma solicitação de pull, um bot cla determinará automaticamente se você precisa fornecer um CLA e decorar a 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 oCódigo de Conduta de Software Livre da Microsoft. Para obter mais informações, consulte as perguntas frequentes sobre o Código de Conduta ou entre em contato com opencode@microsoft.com com perguntas ou comentários adicionais.

Marcas comerciais

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