BDD & Automação10 min de leitura

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.

Por Engenharia de Qualidade teste.ai · Paiva Software Engineering

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:

  1. 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.
  2. 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.
  3. 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 .feature servem 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 em describe / test no 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.

Continue aprofundando sua Engenharia de Qualidade