Desmistificando Cucumber e Gherkin: A Arte da Automação de Testes de Software
Entenda na prática a diferença arquitetural entre BDD, Gherkin e Cucumber, como estruturar Step Definitions limpos com Page Objects e evitar as armadilhas clássicas de manutenção.
Poucos temas geram tanta confusão conceitual no mercado de Engenharia de Qualidade quanto a tríade BDD, Gherkin e Cucumber. É comum encontrar vagas e projetos tratando os três termos como sinônimos — ou pior, adotando o Cucumber apenas como uma camada burocrática extra sobre Selenium ou Playwright sem nenhuma colaboração real com o time de negócio.
Neste artigo técnico, desmistificamos o papel exato de cada peça na arquitetura de automação e mostramos como implementar uma camada de Step Definitions limpa, desacoplada e fácil de manter.
BDD vs. Gherkin vs. Cucumber: Separando os Conceitos
Para projetar uma arquitetura sólida, cada conceito precisa ocupar seu lugar exato:
- BDD (Behavior-Driven Development): É uma prática colaborativa de engenharia de software (evoluída do TDD por Dan North). Acontece antes de escrever código, em sessões rápidas como os Três Amigos (Produto + Dev + QA), onde exemplos concretos revelam ambiguidades nos requisitos.
- Gherkin: É a gramática estruturada de texto puro (
Funcionalidade,Cenário,Dado,Quando,Então) usada para documentar esses exemplos de negócio de forma não ambígua em arquivos.feature. - Cucumber: É o motor de execução (test runner) que lê cada linha do arquivo
.feature, faz o casamento de padrões (Cucumber Expressions ou Regex) com funções de código chamadas Step Definitions e aciona o driver de automação (Playwright, Selenium, REST Assured, Appium).
Arquitetura em 3 Camadas: O Segredo para Não Criar um Monstro de Manutenção
Quando equipes colocam chamadas diretas de driver.findElement(...) ou page.locator(...) dentro dos Step Definitions, o projeto rapidamente colapsa em código duplicado. A arquitetura recomendada em produção separa rigorosamente três responsabilidades:
[ Camada 1: Especificação de Negócio (.feature em Gherkin) ]
│
▼
[ Camada 2: Cola Fina / Step Definitions (Cucumber TS/Java/Python) ]
│
▼
[ Camada 3: Automação de Domínio (Page Objects / API Clients) ]
Exemplo Completo em TypeScript (Cucumber.js + Playwright Page Object)
1. Arquivo .feature (O Quê — Negócio):
# language: pt
Funcionalidade: Aplicação de cupom promocional no checkout
Cenário: Aplicar cupom corporativo válido acima do pedido mínimo
Dado que o carrinho possui itens somando "R$ 300,00"
Quando o comprador aplica o cupom promocional "PRO17OFF"
Então o desconto de "R$ 51,00" deve ser exibido no resumo
E o valor final a pagar deve ser "R$ 249,00"
2. Page Object (CheckoutPage.ts — Como a UI Funciona):
import { Page, expect } from '@playwright/test';
export class CheckoutPage {
constructor(private readonly page: Page) {}
async aplicarCupom(codigo: string): Promise<void> {
await this.page.getByLabel('Cupom de desconto').fill(codigo);
await this.page.getByRole('button', { name: 'Aplicar' }).click();
}
async validarResumoFinanceiro(descontoEsperado: string, totalEsperado: string): Promise<void> {
await expect(this.page.getByTestId('checkout-discount')).toHaveText(descontoEsperado);
await expect(this.page.getByTestId('checkout-total')).toHaveText(totalEsperado);
}
}
3. Step Definitions (checkout.steps.ts — Ponte Enxuta):
import { Given, When, Then } from '@cucumber/cucumber';
import { CustomWorld } from '../support/world';
Given('que o carrinho possui itens somando {string}', async function (this: CustomWorld, subtotal: string) {
await this.cartApi.criarCarrinhoComValor(subtotal);
await this.checkoutPage.abrir();
});
When('o comprador aplica o cupom promocional {string}', async function (this: CustomWorld, cupom: string) {
await this.checkoutPage.aplicarCupom(cupom);
});
Then('o desconto de {string} deve ser exibido no resumo', async function (this: CustomWorld, desconto: string) {
this.descontoEsperado = desconto;
});
Then('o valor final a pagar deve ser {string}', async function (this: CustomWorld, total: string) {
await this.checkoutPage.validarResumoFinanceiro(this.descontoEsperado, total);
});
Repare em um detalhe crucial de performance na linha do Given: em vez de navegar lentamente por 5 telas de catálogo para adicionar produtos ao carrinho via interface gráfica, o passo prepara o estado inicial via API (cartApi) em milissegundos e abre diretamente o checkout!
Quando Usar (e Quando NÃO Usar) Cucumber
- Use Cucumber quando: POs, analistas de negócio e QAs revisam ativamente os critérios de aceite em conjunto e os arquivos
.featureservem como fonte oficial das regras do produto. - Evite a sobrecarga quando: Apenas engenheiros técnicos leem os testes e ninguém do negócio jamais abre os arquivos
.feature. Nesse caso, testes diretos emdescribe / testno Playwright, Cypress ou JUnit entregam menos boilerplate e maior velocidade.
Gere Cenários Gherkin e Código Cucumber Multi-Linguagem em 1 Clique
Precisa transformar requisitos extensos em arquivos .feature padronizados já acompanhados dos respectivos Step Definitions em TypeScript, JavaScript, Java ou Python? Experimente as ferramentas Linguagem Gherkin e Código Cucumber dentro do teste.ai v.3.0 e acelere sua automação com padrão sênior desde o primeiro commit.
Plataforma de QA End-to-End • teste.ai v.3.0
Pare de escrever planilhas e scripts de teste do zero.
Teste gratuitamente o teste.ai v.3.0 agora mesmo: receba 5 gerações completas na hora (sem cartão de crédito), organize suítes em nuvem e exporte relatórios executivos em PDF e Excel.