O projecto de testes
O que são os testes de uma app, onde vivem, como são executados sem tocar nos dados reais, e o minitab Testes.
Cada app tem o seu projecto de testes: um conjunto de testes automáticos que diz, a cada alteração, se o que funcionava continua a funcionar. Um teste é uma lista de passos, como abrir um ecrã, preencher um campo, carregar num botão e verificar o que aparece, e constrói-se como o resto da plataforma: a arrastar e a escolher.
Há quatro tipos de teste, e um teste pode misturar passos de todos:
| Tipo | O que verifica | Exemplo |
|---|---|---|
| Ecrã | Um percurso de quem usa a app: abrir, preencher, clicar, ver. | Criar uma conta nova e ver a linha na tabela. |
| API | Uma operação GraphQL da app: a resposta, o tempo, o efeito nos dados. | getContas devolve só contas da Indústria, em menos de 500 ms. |
| Script | A execução de um script: o que devolve e o que escreve. | O script de sincronização cria três contactos. |
| Workflow | O percurso de um processo: tarefas, decisões, notificações. | Um pedido acima de 10 dias vai para a direcção e, aprovado, avisa quem pediu. |

Onde vivem os testes
Os testes fazem parte da app, como os ecrãs e as APIs:
- ficam em cada versão da app, e fundem-se com as outras alterações no merge (ver Histórico e merge);
- aparecem no histórico da app, com quem os alterou;
- viajam na exportação da app e entram nos templates;
- têm checkout, como os outros documentos: duas pessoas não gravam o mesmo teste ao mesmo tempo.
O que fica só nesta instalação são os resultados das execuções (guardados 30 dias).
Como são executados sem tocar nos dados reais
Cada teste é executado num ambiente de teste novo, criado para ele e apagado no fim:
- As bases de dados são cópias de teste. Uma base interna da app começa com a mesma estrutura da real, sem linhas, e recebe os dados de teste. O que um teste grava não chega à base real nem ao teste seguinte.
- As contas são as que escolher no ambiente de teste, uma por papel, entre as contas da app. Um teste sem papel é um visitante, sem sessão, e só vê o que é público.
- Os emails e as notificações ficam retidos no teste, para o teste os verificar, e nunca saem.
- Os pedidos HTTP das APIs e dos workflows recebem as respostas simuladas do ambiente de teste, e nunca saem para a rede.
- Os erros que um teste provoca não aparecem no Radar nem geram alertas.
Atenção
Uma base de dados externa com escrita (a base de um ERP, por exemplo) não se copia: os testes usam outro datasource da app, o datasource de teste, que se escolhe no ambiente de teste. Enquanto ele faltar, nenhum teste da app é executado. Ver O ambiente de teste.
O minitab Testes
Os testes estão no minitab Testes da árvore da app, entre Dados e Radar. Os minitabs mostram só o ícone: passe o rato por cima para ver o nome.
O painel tem:
- Testes: os testes por pasta, cada um com o resultado da última execução (verde passou, vermelho falhou, vazio ainda não foi executado). Para mudar um teste de pasta, arraste-o para a pasta.
- Dados de teste: os conjuntos de linhas que os testes carregam.
- Execuções: as execuções recentes; abrir uma mostra o resultado.
- Instáveis: os testes que passam e falham alternadamente.
No topo ficam a procura, Novo teste, Nova pasta de testes, Ambiente de teste e Executar todos os testes.
Perguntas frequentes
Porque aparece «Os testes não são executados»? A app tem uma base externa com escrita sem datasource de teste. Abra o Ambiente de teste e escolha-o, ou peça a um administrador.
Um teste pode estragar os dados reais? Não. Os testes escrevem só nas cópias de teste. A única base real que um teste lê é uma base externa em Só leitura, e nessa a plataforma recusa qualquer escrita.
Quem pode escrever e executar testes? Quem tem o perfil Developer na app. O ambiente de teste só um administrador o muda.