Gravar um teste
O que gravar, a contagem regressiva, a barra de ferramentas da gravação e os hábitos que tornam um teste confiável.
O que gravar
Gravar é uma das duas maneiras de criar um teste: você percorre o cenário uma vez, e o GUI Test Studio gera o teste a partir da gravação, de forma visual, pronto para executar e para editar a qualquer momento.A outra maneira é descrever o fluxo de trabalho em um prompt, e o seu assistente de IA o grava para você.Prefere trabalhar sem IA?Grave: não é preciso mais nada.
A página inicial do GUI Test Runner-Recorder mostra as duas maneiras lado a lado, no cartão Criar um novo teste: Gravar você mesmo, com o botão vermelho Gravar, e Criar teste a partir de um prompt.Clique em Gravar.Antes de cada gravação, o aplicativo pergunta o que você deseja testar.
A pergunta mostra cinco imagens, uma por opção: a tela inteira, um aplicativo, um aplicativo web, uma área da tela e um celular.Clique em uma imagem e as configurações dela aparecem abaixo da fileira; depois clique no botão vermelho Gravar.Na primeira vez, um breve guia apresenta as cinco.
Vários monitores: qual tela
Em um computador com vários monitores, uma pergunta a mais vem antes: Qual tela este teste deve usar? Os monitores são desenhados como estão na sua mesa.Clique em um para gravar só esse monitor, ou em Todas as telas para um aplicativo que abre as suas janelas em qualquer um deles.Aquele em que você clica se ilumina por um momento na tela real, para que você saiba qual é.
A pergunta é feita uma vez por sessão; as gravações seguintes mantêm a resposta.Marque Não perguntar novamente para manter a sua escolha de vez: ela passa a ficar em Configurações, Preferências, Padrões de gravação, no cartão Tela, como Gravar em, com a chave que traz a pergunta de volta.
Um teste é executado na tela em que está o GUI Test Runner-Recorder, de modo que o navegador ou o aplicativo que ele abre aparece onde você está trabalhando.Um teste gravado em outro monitor continua sendo executado lá.Para executá-lo em outro lugar, ou em todas as telas, altere Executar em nas Configurações do projeto do teste.Veja Executar um teste.
As cinco opções, e quando escolher cada uma
A tela inteira
Tudo o que está no monitor principal pode receber asserções.Escolha esta opção para um primeiro teste, quando o seu cenário passa por vários aplicativos ou janelas, ou quando você não tem certeza.
Um aplicativo
Escolha esta opção quando o seu cenário fica dentro de um único aplicativo de desktop.Só as janelas, caixas de diálogo e menus desse aplicativo recebem asserções automáticas, então uma notificação de outro programa nunca vai parar no seu teste.
Escolha o aplicativo na lista de aplicativos abertos, ou clique em Procurar... para um programa que ainda não está aberto.Marque a caixa que inicia o aplicativo no começo do teste e o fecha no fim, e cada execução começa com o aplicativo recém-aberto.
Um aplicativo web
Escolha esta opção quando o que você testa é um site ou um aplicativo web.Digite o endereço e escolha o navegador.A página abre em uma janela limpa em tela cheia, sem as suas guias nem os seus logins, e a gravação começa assim que a página carrega.A partir daí, o teste abre e fecha o navegador sozinho em cada execução.
Marque Gerar também este teste para outros navegadores e dispositivos para obter o mesmo teste também para Chrome, Edge e Firefox, celulares, tablets e outros tamanhos de tela, criado logo depois que você salva.Veja Todos os navegadores e dispositivos a partir de uma gravação.
Uma área da tela
Escolha esta opção quando só uma parte da tela importa: um painel, um formulário, a visão de um jogo.Clique em Selecionar na tela... e desenhe a área.As asserções automáticas vêm só de dentro dela.
Um celular (Android)
Escolha esta opção quando o que você testa é um aplicativo Android.Conecte o celular por USB: a tela dele aparece em uma janela na sua, e o que você faz nessa janela acontece no celular.A pergunta diz quando o celular está pronto, ou o que ainda falta.
Na dúvida?Comece pelo que você testa
| Você está testando | Escolha |
|---|---|
| Um aplicativo de desktop | Um aplicativo |
| Um site ou um aplicativo web | Um aplicativo web |
| Vários aplicativos trabalhando juntos, ou você não tem certeza | A tela inteira |
| Um painel de uma tela cheia de coisas, ou a visão de um jogo | Uma área da tela |
| Um aplicativo Android | Um celular (Android) |
Durante a gravação
O aplicativo sai do caminho e faz uma contagem regressiva de três segundos, para que você possa começar o seu cenário com calma.
Quando o GUI Test Runner-Recorder abre um aplicativo web ou inicia um aplicativo para você, não há contagem regressiva.Ele pede que você não use o mouse nem o teclado, e a gravação começa no momento em que a página ou o aplicativo está pronto.
Uma pequena barra de ferramentas fica perto da parte de baixo da tela enquanto você grava.Ela nunca faz parte da gravação, e você pode arrastá-la para fora do caminho.
| Botão | O que faz |
|---|---|
| Gravar novamente | Descarta esta tomada e começa uma nova.Nada é salvo. |
| Pausar / Retomar | Pausa a gravação por um momento, para preparar algo que não faz parte do teste. |
| Encerrar | Termina a gravação.Em seguida você escolhe o que o teste verifica e o salva. |
Os cliques do mouse, os arrastos, a rolagem e a digitação no teclado são todos gravados, assim como um gamepad quando você o ativa nas Preferências.
Cada tecla que você pressiona guarda o layout de teclado em que foi digitada.Um teste que troca de layout no caminho, do francês para o inglês, por exemplo, digita cada tecla no seu próprio layout quando é executado.Se o computador que executa o teste não tiver um desses layouts, o relatório informa isso; isso por si só nunca é uma falha.
Hábitos para um teste confiável
Um teste reproduz exatamente o que você fez.Alguns hábitos durante a gravação fazem com que ele seja aprovado sempre.
Do
- Comece de um estado conhecido: sem login, na página inicial, com o carrinho vazio
- Espere cada tela terminar de carregar antes de clicar nela
- Clique no meio dos botões e dos campos, não nas bordas
- Use dados de teste que sejam os mesmos em todas as execuções
- Mantenha cada teste curto e sobre uma única coisa: entrar, buscar, finalizar a compra
Avoid
- Clicar enquanto uma página ainda está carregando
- Mover ou redimensionar janelas no meio de um cenário
- Depender de algo que sobrou de uma execução anterior
- Notificações e pop-ups de outros aplicativos durante a gravação
- Um único teste muito longo que cobre tudo
Teclas para lembrar
| Tecla | Durante a gravação | Durante a execução |
|---|---|---|
| Esc | Encerra a gravação | Cancela a contagem regressiva |
| F1 | Pausa e retoma | |
| F2 | Interrompe a execução na hora |
Você pode alterar essas teclas em Configurações, Preferências.
Gravar um celular
Ative a depuração USB no celular Android, conecte-o e permita o computador uma vez na tela do celular.A pergunta mostra as etapas quando o celular ainda não está pronto.Veja Web, celulares, máquinas virtuais e jogos.
Quando você encerra
O aplicativo volta e pergunta o que este teste deve verificar, e depois onde salvá-lo.Continue com Escolher o que um teste verifica.
A outra maneira: descrever o teste
Criar teste a partir de um prompt, ao lado de Gravar, abre uma janela em que você escreve o que o teste deve fazer, escolhe um exemplo para começar e o envia ao seu assistente de IA: Claude Desktop, Claude Code, ChatGPT com Codex ou VS Code, ou cria o teste com um modelo de IA local, um que nós fornecemos ou um que você traz.O assistente então executa as etapas na sua tela, verifica à medida que avança e salva o mesmo tipo de teste.Veja Criar um teste a partir de um prompt.
Ainda com problemas?Conte o que você estava tentando fazer, e respondemos em até um dia útil.Ask our team