Automação de testes do Playwright

Automações do Playwright como um tipo de automação do Test Manager ao lado de automações de autoria do Studio, sem reescrever conjuntos de testes existentes no Studio.

Observação:

This capability is in controlled availability, delivered only to eligible tenants. It is available in Test Manager only when delivered through Test Cloud, and UiPath must enable it for your tenant before it works, which requires contacting your UiPath account team with your tenant details to request enablement.

O Test Manager pode executar casos de teste apoiados por automações do Playwright, além de automações criadas pelo Studio (robô). As equipes que já escrevem testes de ponta a ponta no Playwright podem trazer esses testes para o Test Manager para orquestração, agendamento, relatórios e rastreabilidade, sem reescrevê-los no Studio.

Pré-requisitos

Antes que uma automação Playwright possa ser executada a partir do Test Manager, a conta de robô usada para execução (por exemplo, uma conta de robô não assistida configurada para testes serverless) deve ser adicionada ao projeto do Test Manager em Configurações do projeto, com a função Executor de teste . A associação no grupo Automation Users isoladamente não concede isso. Sem a função Executor de testes, os testes ainda são executados e concluídos, mas os resultados nunca alcançam o Test Manager, pois cada execução de caso de teste terminaria com um resultado de None e uma entrada de log:

Playwright test execution faulted before results could be uploaded.

{
  "Code": "Serverless.PlaywrightTest.ResultUploadFailed",
  "Title": "Failed to upload Playwright results to Test Manager",
  "Detail": "The tests ran but an artifact upload URL could not be obtained from Test Manager, so the results were never uploaded. Check that Test Manager is reachable from the pod and the execution context is complete. The execution will be reconciled, but per-test results may be missing."
}

Playwright automations end to end

Um projeto de teste do Playwright vive em seu próprio sistema de controle de origem, fora da UiPath. De lá, a automação chega ao Test Manager por meio do seguinte fluxo:

1. O projeto é empacotado em um pacote de automação da UiPath usando o comando tm pack da interface de linha de comando (CLI) da UiPath e, em seguida, publicado no Global Tenant-Wide Package Feed do Orchestrator ou em um feed dedicado no nível da pasta. Para obter as etapas de empacotamento, consulte Empacotamento de projetos do Playwright para o Test Manager.
2. Você pode selecionar o pacote publicado no Test Manager da mesma forma que uma automação publicada pelo Studio, por meio do fluxo Seleção de automação.
3. Se o pacote foi criado com uma chave de projeto do Test Manager, casos de teste correspondentes são criados automaticamente e a automação do Playwright é vinculada automaticamente a cada um deles assim que o Test Manager ingere o pacote. Caso contrário, criamos o caso de teste separadamente e vinculamos a automação manualmente, usando o mesmo fluxo que usamos para as automações do Studio.
4. A partir desse momento, o caso de teste se comporta como qualquer outro caso de teste automatizado no Test Manager: você pode colocá-lo em conjuntos de testes, dispará-lo sob demanda ou em um agendamento, e seus resultados, artefatos e links de rastreabilidade aparecem junto com todos os outros casos de teste.

O que o Test Manager captura de seu projeto do Playwright

Campo do Test Manager	Vem do Playwright
Nome e Descrição	Apenas título de teste. Os metadados do pacote não carregam um campo de descrição, portanto a descrição não é preenchida.
Rótulos	@tag / valores de anotação (por exemplo, resilience, observability), copiados para o caso de teste como rótulos para filtragem e escopo de conjuntos de teste.
Arquivo de projeto/especificação	O projeto Playwright (de playwright.config.ts) e o arquivo de especificações aos quais o teste pertence, capturados como metadados. Criamos um caso de teste por teste — não há distribuição por projeto.
Origem (guia Selecionar automação)	Um valor de origem de Playwright ou UiPath, mostrado no seletor Selecionar automação.

Observação:

Nome e Descrição, Rótulos e Arquivo de Projeto/especificações são todos implementados como rótulos de sistema gerados automaticamente no caso de teste. Apenas Origem é um campo separado, exibido como sua própria coluna no seletor selecionar automação em vez de como um rótulo.

For the fields and system labels that Test Manager populates on a test case linked to a Playwright automation, see Playwright test case fields.

Test Manager - Playwright terminology

• Automação e caso de teste permanecem como tipos de artefatos distintos no Test Manager.
• Uma automação, seja Playwright ou Studio, é atribuída a um caso de teste.
• Um teste de Playwright nunca é chamado de caso de teste.

Execução e paridade de relatórios

Uma vez atribuído, um caso de teste com suporte do Playwright é executado, agendado e relatado exatamente como um criado pelo Studio: mesmos gatilhos, mesmas regras de associação de conjuntos de Testes, mesmos resultados e visualizações de rastreabilidade.

Restrições conhecidas

Limitação	O que isso significa
Apenas Chromium	O pod de execução instala apenas o Chromium. Um projeto configurado para usar o Firefox ou o WebKit ainda pode ser selecionado, mas a execução não ocorre nesse navegador.
Apenas execução sem servidor	Os testes de Playwright ocorrem apenas na infraestrutura sem servidor da UiPath, com um pod dedicado por execução. A execução de robô on-premises ou local ainda não é compatível.
Apenas Node.js (JavaScript/TypeScript)	Apenas baseado em Node.js Projetos de Playwright são suportados. playwright-python, playwright-java e projetos playwright-dotnet não são compatíveis.
É necessário um projeto independente	Cada projeto deve ser empacotado a partir de um diretório independente, com dependências resolvidas na raiz empacotada. Uma subpasta mono-repo funciona apenas se for independente.
Sem detalhes no nível de asserção	O Test Manager não expõe as asserções do Playwright individualmente. Ele depende do resultado de aprovação/falha por tentativa do Playwright e dos anexos configurados.
Sem importação de resultados executados externamente	Não é possível importar resultados de um conjunto de Playwright executado fora do Test Manager, por exemplo, na CI do próprio cliente.
Trabalho único por execução	Todos os casos de teste em uma execução de conjunto de testes do Playwright são executados dentro de um único trabalho do Orchestrator — um conjunto de testes superdimensionado corre o risco de um tempo limite do trabalho.
Limite de tempo de execução	Uma execução de conjunto de testes do Playwright tem um limite de tempo de 45 minutos, separado dos limites de tempo de gravação de vídeo que se aplicam em outras partes do Test Manager.
Sem sharding de vários pods	Todo o conjunto funciona em um pod por execução. O paralelismo de trabalho do Playwright se aplica conforme configurado, mas o sharding distribuído entre pods ainda não está disponível.
Sem relatórios por fixture	As fixtures do Playwright (test.extend()) são executadas normalmente, mas o Test Manager não as modela com relatórios no nível de caso de teste ou por fixture.
Sem autocorreção	A autocorreção com agentes ainda não está disponível para automações do Playwright.
Sem aplicação de ordem de execução	A ordem dos casos de teste é a seguinte playwright.config.ts. Habilitar Aplicar ordem de execução, Cobertura da atividade de RPA ou Healing Agent em um conjunto de testes do Playwright faz com que a execução apresente falha rapidamente.
Não é permitido misturar pacotes ou versões diferentes	A combinação de casos de teste de dois pacotes do Playwright diferentes, ou do mesmo pacote em duas versões diferentes, em um conjunto de testes é bloqueada.
Conjuntos de testes orientados por dados executam todas as variações	Cada variação de um teste Playwright parametrizado é seu próprio caso de teste. A execução de uma variação executa todas as variações nessa linha.
Sem gravação de vídeo ou transmissão ao vivo da UiPath	Habilitar a Gravação de vídeo em um conjunto de testes do Playwright não tem efeito, e a guia Gravação e a ação de transmissão ao vivo não mostram dados. A captura de vídeo do próprio Playwright (use: { video } em playwright.config.ts) não é afetada — esses arquivos .webm ainda são anexados como artefatos.

Os casos de teste definidos como chamadas test() independentes, cada um em sua própria linha, são executados de forma independente. O Visualizador de trace mostra o próprio resultado de cada variação e os logs de execução mostram cada variação como tendo sido executada.

Licenciamento

Running a Playwright test through Test Manager consumes the same platform capacity as any other serverless test execution, at the underlying robot-execution level — there's no different consumption rate for Playwright versus native UiPath test automations. For details, see Consumables.

Artigos relacionados

• Como funciona a captura de artefatos do Playwright
• Empacotamento de projetos do Playwright para o Test Manager
• Configuração de captura de artefatos para testes do Playwright
• Selecionando a automação
• Campos de caso de teste do Playwright