Introdução aos testes
Os testes são pequenos arquivos TypeScript no workspace do seu app. Seu agente os escreve e executa em um navegador real contra o seu app Bubble, e o Buildprint registra cada execução.
Por que os testes são arquivos
Cada etapa é um comando de shell. Isso torna as execuções dos testes determinísticas, rápidas e econômicas. Agentes de IA são usados apenas para iniciar um teste ou responder a etapas de entrada do agente que exigem julgamento qualitativo.
Os testes ficam no workspace, junto às suas páginas e aos seus workflows, portanto são versionados e implantados com o seu app.
Seu agente pode lê-los, escrevê-los e depurá-los com as mesmas ferramentas que usa no restante do app.
O que é um teste
Um teste é um arquivo dentro de tests/ no workspace clonado.
Um teste contém:
Configuração: etapas que preparam os dados, como limpar um campo do usuário do testador.
Etapas: o que o teste faz e verifica. Cada etapa é um comando de shell. Uma etapa pode ser uma verificação no navegador ou uma asserção de que um registro específico existe, por exemplo.
Limpeza: etapas que fazem a limpeza (por exemplo, redefinindo os dados de teste)
Requisitos: elementos, páginas ou tipos de dados de que o teste precisa. Se uma branch não tiver esses itens, o teste ficará inativo nessa branch.
As etapas usam agent-browser para clicar, digitar, esperar e ler a página. Elas podem usar a CLI do Buildprint para pesquisar e alterar dados. Tudo o que você pode fazer em um terminal pode ser uma etapa.
Componentes
Um componente é uma sequência reutilizável de etapas, como um login, por exemplo. Os componentes ficam em tests/components/. Um teste chama um componente como uma função e passa parâmetros.
Etapas do agente
Algumas verificações não podem ser feitas por um comando. Por exemplo, dizer que “um gráfico está correto” ou que “um layout não está quebrado”. Para esses casos, um teste pode ter uma etapa do agente. O executor pausa, faz uma captura de tela e encaminha a decisão ao seu agente. O agente registra aprovação, reprovação ou aviso, e a execução continua.
Use etapas do agente somente quando um comando não puder realizar a verificação, para garantir que os testes continuem rápidos e eficientes.
Onde os testes são executados
Os testes são executados na sua máquina ou na máquina do seu agente, por meio da CLI do Buildprint. Cada execução tem como alvo uma branch do seu app no modo de execução. O executor usa a branch do workspace a partir da qual você executa o teste.
O Buildprint armazena cada execução para que você possa revisá-las no app, em Testes.
Como tudo se encaixa
Peça ao seu agente para escrever um teste.
O agente aplica o teste ao Buildprint, assim como faz com outras edições no Bubble.
Peça ao agente para executar um ou mais testes.
Abra Testes no Buildprint para ver os resultados.