Olá, usuários Apidog! 👋 Ao longo do último ano, construímos uma plataforma abrangente de testes automatizados em torno dos Test Scenarios (Cenários de Teste)—sequências de fluxo de trabalho reutilizáveis que encadeiam múltiplas requisições de API em fluxos de negócios completos. Os Test Scenarios resolvem o problema de "como testar", mas temos recebido feedback consistente das equipes sobre um desafio diferente: "como organizar o que testar."
As equipes nos dizem que possuem centenas de casos de teste organizados por módulos de negócios, mas quando chega a hora da regressão para um lançamento, elas querem executar apenas seus casos P0—não tudo. Atualmente, elas precisam pesquisar e selecionar cada um manualmente. Outras mantêm casos de teste positivos e negativos, mas desejam que os testes de fumaça (smoke tests) cubram apenas os fluxos positivos. E quando novos casos são adicionados, eles frequentemente são esquecidos nas listas de regressão.
Hoje, estamos introduzindo as Test Suites (Conjuntos de Testes): um novo tipo de recurso que permite organizar e executar testes por regras, em vez de por seleção individual. As Test Suites trazem três capacidades principais para o seu fluxo de trabalho de testes:
- Roteamento dinâmico de testes: Defina regras de filtragem uma vez—por tags, diretórios ou níveis de prioridade—e os casos correspondentes são incluídos automaticamente em tempo de execução. Novos casos que atendam aos seus critérios são adicionados sem manutenção manual.
- Execução paralela: Alterne entre os modos serial e paralelo com um clique. O sistema otimiza automaticamente a concorrência com base nos recursos disponíveis, reduzindo regressões de horas para minutos.
- Relatórios de teste estruturados: Visualize os resultados agrupados pela lógica da sua organização—por módulo, prioridade ou tag—em vez de rolar por listas planas. Casos falhos aparecem imediatamente com contexto claro.
Aqui está um olhar mais atento sobre como cada capacidade funciona.
Roteamento dinâmico de testes
A solicitação mais comum que ouvimos das equipes de QA é: "Quero executar todos os casos P0 no módulo de pagamento sem selecioná-los um por um." As Test Suites resolvem isso separando a autoria de testes da organização de testes.
Os Test Scenarios continuam sendo seus blocos de construção—cada um representa um fluxo de trabalho de negócios completo (login, criar pedido, pagar, verificar status). As Test Suites permitem agrupar esses cenários por condições: tags, diretórios, níveis de prioridade ou qualquer combinação. Ao executar uma suite, ela inclui automaticamente todos os casos correspondentes no momento da execução.
Isso se torna cada vez mais importante à medida que as ferramentas de desenvolvimento impulsionadas por IA aceleram a geração de código e de testes. Com suites dinâmicas, você não precisa atualizar manualmente as listas de regressão toda vez que um novo caso é adicionado. Escreva o caso, aplique as tags corretas e a suite cuida do resto.
Suportamos dois modos para atender a diferentes necessidades de teste:
O modo estático oferece uma lista fixa de casos. Você seleciona exatamente quais cenários incluir, e essa lista permanece inalterada até que você a modifique. Isso funciona bem para testes de fumaça (smoke tests)—um conjunto selecionado de 5-15 cenários críticos que raramente mudam, mas são executados com frequência.
O modo dinâmico usa regras para incluir automaticamente os casos correspondentes. Defina uma condição (todos os casos no diretório "Pagamento" com prioridade P0), e a suite se mantém atualizada conforme sua biblioteca de testes evolui. Isso funciona bem para regressão de módulos, onde a contagem de casos muda regularmente.
Na interface do produto, nós o guiamos através dessa escolha sem exigir que você entenda a terminologia de antemão. Quando você seleciona o modo estático, caixas de seleção aparecem para seleção individual. Quando você seleciona o modo dinâmico, você vê uma pré-visualização somente leitura dos casos correspondentes com uma nota: "Novos casos que corresponderem a essas condições serão incluídos automaticamente."
Execução paralela
Quando sua suite de testes cresce para centenas de casos, a execução serial se torna um gargalo. Uma regressão completa que leva uma hora para ser concluída atrasa seu pipeline de lançamento e retarda a detecção de problemas no monitoramento de produção.
As Test Suites suportam execução paralela pronta para uso (out of the box). Basta alternar entre o modo serial e paralelo—o sistema determina automaticamente a concorrência ideal com base nos recursos disponíveis da sua máquina. Nenhuma ajuste manual é necessário. Isso reduz uma regressão de 60 minutos para menos de 30 minutos sem alterar sua lógica de teste.
A execução paralela lida com o isolamento de dependências automaticamente. Cada cenário é executado em seu próprio contexto, garantindo que variáveis compartilhadas ou o estado do ambiente de um cenário não interfiram em outro. Para cenários que dependem genuinamente uns dos outros, você pode agrupá-los em um único cenário com etapas sequenciais.
Relatórios de teste estruturados
Os relatórios de teste tradicionais listam os resultados um por um. Ao executar uma suite com 200 casos em vários módulos, encontrar as falhas que importam se torna tedioso.
Os relatórios das Test Suites são estruturados em torno da lógica da sua organização. Os resultados são agrupados pelas condições que você definiu—por módulo, por prioridade, por tag. Você pode ver imediatamente que "Módulo de Pagamento: 45/47 aprovados" e "Módulo de Usuário: 32/32 aprovados" sem rolar por entradas individuais.
Cada grupo se expande para mostrar os resultados individuais dos cenários com tempo de execução, contagens de asserções e detalhes da falha. Cenários falhos aparecem no topo com contexto de erro claro, para que você possa priorizar problemas sem procurar em logs.
Os relatórios também incluem metadados de execução: duração total, eficiência paralela (tempo economizado em comparação com a execução serial) e configuração de ambiente utilizada. Isso ajuda você a otimizar a configuração da suite ao longo do tempo e fornece trilhas de auditoria para requisitos de conformidade.
Configuração unificada com substituições flexíveis
Cada Test Scenario pode ter sua própria configuração de execução: ambiente, contagem de loops e outras configurações. Ao agrupar múltiplos cenários em uma suite, você precisa decidir qual configuração terá precedência.
Por padrão, cada cenário é executado com sua configuração salva—o comportamento mais intuitivo. Para configurações de ambiente especificamente, a suite oferece um seletor de ambiente unificado que os cenários podem herdar. Isso permite que você mude toda a sua suite de regressão de staging para produção com uma única alteração.
Se você precisa de controle total, pode especificar uma configuração personalizada que substitui todas as configurações em nível de cenário. Esta opção está disponível em configurações avançadas para manter o caminho comum simples.
Test Suites vs. execuções em lote de diretórios
O Apidog já suporta execuções em lote no nível de diretório. As Test Suites servem a um propósito diferente.
Diretórios organizam casos por estrutura física. Um caso pertence a uma pasta.
Test Suites organizam casos por regras lógicas. Um caso pode pertencer a múltiplas suites simultaneamente.
Por exemplo: Um caso de teste de pagamento P0 pode aparecer tanto em "Regressão do Módulo de Pagamento" (todos os casos P0/P1 marcados como pagamento) quanto em "Teste de Fumaça Completo" (todos os casos P0 em todo o sistema). Essa flexibilidade permite que você construa unidades de execução de teste reutilizáveis para diferentes cenários—testes de fumaça acionados a cada commit, regressão completa antes dos lançamentos e verificações de saúde agendadas em produção.
Capacidade | Propósito | Melhor para |
|---|---|---|
Test Scenario | Orquestração de fluxo de negócios | Definição de fluxos de trabalho de teste individuais |
Diretório | Organização física | Colaboração em equipe, gerenciamento de casos |
Execução em lote de diretório | Execução rápida | Teste exploratório, regressão ad-hoc |
Test Suite | Unidade de execução reutilizável | Regressão de lançamento, testes de fumaça, monitoramento agendado |
O que estamos construindo a seguir
Estamos avaliando o aninhamento de suites (compor suites a partir de outras suites) e a nova tentativa automática em caso de falha. O modo dinâmico já lida com a maioria das necessidades de composição, e queremos evitar mascarar falhas genuínas com novas tentativas. Reavaliaremos com base nos padrões de uso.
Como começar
As Test Suites já estão disponíveis no Apidog. Crie sua primeira suite a partir do módulo de Testes Automatizados, selecione o modo estático ou dinâmico, defina suas condições e execute. Integre com seu pipeline de CI/CD usando o CLI para acionar suites na fusão de código ou por agendamento.
Participe da Conversa
Gostaríamos de saber como as Test Suites se encaixam no seu fluxo de trabalho. Compartilhe seu feedback em nossos canais da comunidade. Conecte-se com outros engenheiros de API e com a equipe Apidog:
- Discord: Junte-se à nossa comunidade para discussões em tempo real e estratégias de teste
- X (Twitter): Siga-nos para as últimas atualizações de produtos e insights de API
- LinkedIn: Conecte-se conosco para atualizações profissionais e perspectivas da indústriaExplore os detalhes completos de todas essas atualizações no Changelog do Apidog! 🚀
Boas testagens!