Práticas recomendadas

Testes confiáveis usam instruções claras, dados controlados e fluxos curtos com um único objetivo.

Teste uma jornada do usuário por vez

Mantenha cada teste focado em um único objetivo, como criar uma conta, fazer um pedido ou alterar uma senha.

Testes curtos são mais fáceis de entender e executar novamente. Use pastas para agrupar jornadas relacionadas, em vez de colocar um aplicativo inteiro em um único teste.

Escreva etapas claras

Diga ao agente o que fazer, onde fazer e qual resultado comprova que a etapa foi concluída com êxito.

• Use os nomes visíveis de páginas, botões e campos.

• Inclua o texto ou os valores exatos quando forem importantes.

• Mantenha uma ação ou verificação em cada etapa.

• Descreva o resultado esperado em vez de dizer que algo deve “funcionar”.

Por exemplo, use “Insira o endereço de e-mail, selecione Criar conta e verifique se o Painel aparece” como etapas separadas, em vez de “Criar uma conta”.

Reutilize etapas de configuração estáveis

Coloque fluxos repetidos, como fazer login ou abrir um projeto, em componentes reutilizáveis.

Limite o componente à configuração compartilhada por vários testes. As ações específicas do produto devem permanecer no teste para que seu objetivo continue claro.

Use condições para alternativas reais

Adicione uma condição quando o aplicativo puder mostrar validamente mais de um caminho, não para ocultar uma etapa não confiável.

Descreva a condição usando algo que o agente possa ver. Conecte os dois resultados quando o teste precisar lidar com qualquer um deles.

Escolha cuidadosamente o comportamento em caso de falha

Use Interromper em caso de falha quando as etapas posteriores dependerem da etapa atual, como no login ou na navegação.

Use Continuar em caso de falha quando as verificações posteriores ainda puderem fornecer evidências úteis. A etapa com falha ainda afeta o resultado geral.

Controle usuários e dados

Use contas de teste dedicadas com permissões e dados previsíveis.

• Mantenha contas separadas para dados de produção e de desenvolvimento.

• Dê a cada conta apenas as permissões necessárias para o teste.

• Evite contas de clientes reais e dados pessoais.

• Redefina ou recrie registros quando um teste depender de um estado inicial conhecido.

Escolha as configurações corretas do navegador

Ajuste a área de visualização ao dispositivo para o qual a jornada foi projetada.

Defina um tempo limite longo o suficiente para o fluxo completo, incluindo quaisquer esperas ou uploads. Um tempo limite muito longo pode tornar mais lenta a identificação de um teste travado.

Use arquivos somente quando necessário

Anexe apenas os arquivos de que o agente precisa para o teste.

Use arquivos de exemplo estáveis e sem informações privadas. Substitua um arquivo quando seu conteúdo não corresponder mais ao resultado esperado.

Mantenha o modelo consistente

Use o mesmo modelo ao comparar resultados ao longo do tempo.

Um modelo mais avançado pode ajudar em jornadas complexas ou menos previsíveis. Alterar o modelo também pode mudar a forma como o agente interpreta a mesma instrução.

Investigue execuções com falha

Leia a etapa com falha e examine sua captura de tela antes de alterar o teste.

Execute novamente uma vez quando a causa não estiver clara. Falhas repetidas no mesmo ponto geralmente significam que o aplicativo mudou, que os dados iniciais estão incorretos ou que a instrução precisa de mais detalhes.

Faça a manutenção dos testes após alterações no aplicativo

Atualize os testes quando renomear controles visíveis, alterar a navegação ou substituir uma jornada do usuário.

Remova testes e componentes desatualizados. Testes antigos geram ruído e dificultam a identificação de regressões reais.