Pular para o conteúdo
← Todas as ferramentas

Gherkin para Playwright

Cenários de teste em português comum (para PO e QA) viram testes automatizados do Playwright (para dev).

Roda no seu navegador

O que é isto?

Um teste de aceitação descreve, em linguagem comum, como o sistema deve se comportar para quem usa. O formato mais usado se chama Gherkin: uma Funcionalidade, seus Cenários e os passos de cada um, com Dado (a situação), Quando (a ação) e Então (o resultado esperado). Esta ferramenta transforma esse texto num teste do Playwright, que abre um navegador de verdade e repete o roteiro sozinho a cada mudança no sistema.

Para quem descreve (PO, QA)

Escreva os cenários do jeito que você testaria à mão, usando as frases da cola para que o máximo vire código sem ajuda. O roteiro de homologação deixa de ser repetido à mão a cada entrega e vira documentação que roda.

Para quem automatiza (dev)

Receba um teste que compila: a estrutura sai sempre exata e as frases conhecidas já vêm implementadas. As desconhecidas viram passos pendentes, que falham com uma mensagem clara até você implementar o que fazem.

Unitário, integração ou aceitação: qual a diferença?
TipoQuem escreveO que confere
CompilaçãoNinguém: é automáticaSe o código é válido (tipos, nomes). Não diz se a conta está certa.
UnitárioDevUma função isolada, sem navegador. Ex.: o dígito verificador de um CPF.
IntegraçãoDevVárias peças reais juntas. Ex.: a API gravando no banco de dados.
Aceitação (ponta a ponta)PO, QA ou devO sistema inteiro, do jeito que a pessoa usa. É o que esta ferramenta gera.

Os tipos convivem: cada um pega um erro que os outros não enxergam. Muitos testes pequenos na base, poucos grandes no topo.

Frases que viram código

O que está entre aspas é o seu valor. A palavra do começo (Dado, Quando, Então, E) pode variar.

FraseO que faz
Dado que abro a página "/caminho"abre o endereço
Dado que o navegador prefere o idioma "en"simula um navegador em outro idioma
Quando clico no link "Texto"clica no link com esse nome
Quando clico no botão "Texto"clica no botão com esse nome
Quando clico em "Texto"clica em qualquer coisa com esse texto
Quando preencho o campo "Rótulo" com "valor"digita no campo pelo rótulo visível
Quando seleciono "Opção" no campo "Rótulo"escolhe numa lista
Quando marco "Opção"marca uma caixa (desmarco: desmarca)
Quando pressiono "Enter"aperta uma tecla
Então vejo o título "Texto"confere um título visível
Então vejo o texto "Texto"confere um texto visível, igual
Então não vejo o texto "Texto"confere que o texto não está na página
Então estou na página "/caminho"confere o endereço
Então o título da aba é "Texto"confere o título da aba
Então o campo "Rótulo" contém "valor"confere o valor de um campo
Então o botão "Texto" está desabilitadoou habilitado

Código gerado

Ao usar as ferramentas, você concorda com os termos de uso.