Azure Playwright

O Azure Playwright é 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. Com os espaços de trabalho Playwright, você pode liberar recursos com mais rapidez e confiança.

Pronto para começar? Entre no 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, Colaborador ou uma das funções clássicas de administrador.
A 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 Azure com sua conta do Azure.

Crie o espaço de trabalho.

Selecione o botão de menu no canto superior esquerdo do portal e, em seguida, selecione Criar um recurso.
Insira Playwright Workspaces na caixa de pesquisa.
Selecione o cartão Playwright Workspaces e, em seguida, selecione Criar.

Forneça as seguintes informações para configurar um novo espaço de trabalho Playwright:

Campo	Description
Subscription	Selecione a assinatura do Azure que você deseja usar para este espaço de trabalho Playwright.
Grupo de recursos	Selecione um grupo de recursos existente. Ou selecione Criar novo e insira um nome exclusivo para o novo grupo de recursos.
Nome	Insira um nome exclusivo para identificar seu espaço de trabalho. O nome só pode consistir em caracteres alfanuméricos e ter um comprimento entre 3 e 64 caracteres.
Localização	Selecione uma localização geográfica para hospedar seu espaço de trabalho. Esse local também determina onde os resultados da execução do teste são armazenados.

Observação

Opcionalmente, você pode configurar mais detalhes na guia Tags . As tags são pares nome/valor que permitem categorizar recursos e exibir o faturamento consolidado aplicando a mesma tag a vários recursos e grupos de recursos.

Depois de concluir a configuração do recurso, selecione Revisar + Criar.
Revise todas as definições de configuração e selecione Criar para iniciar a implantação do espaço de trabalho Playwright.
Quando o processo for concluído, uma mensagem de êxito da implantação será exibida.
Para exibir o novo espaço de trabalho, selecione Ir para recurso.

Instalar o pacote do Azure Playwright

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

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 os espaços de trabalho do dramaturgo.
Substitua os tempos limite para operações de serviço, se necessário.

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

Obter ponto de extremidade de região

No portal do Azure, 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 do Azure, dependendo da região selecionada ao criar o espaço de trabalho.

Configurar ambiente

Certifique-se de que o PLAYWRIGHT_SERVICE_URL que você obteve na etapa anterior está disponível em seu ambiente.

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

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

npm i --save-dev dotenv

arquivo .env

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

Configurar autenticação

Para executar seus testes de Playwright em seu espaço de trabalho do Azure Playwright, 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. Você pode obter a ID do locatário no portal do Azure, consulte Localizar seu locatário do Microsoft Entra. Depois de obter o ID, inicie sessão utilizando o comando az login --tenant <TenantID>

Configurar a autenticação usando tokens de acesso

Você pode gerar um token de acesso do seu espaço de trabalho do Azure 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, habilite a 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

OBSERVAÇÃO: Para usar o Azure Playwright 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.

Contributing

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 Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato opencode@microsoft.com com quaisquer 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 as Diretrizes de Marcas Comerciais e 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.

Feedback

Esta página foi útil?

Last updated on 2025-08-29