Skill de Automação Geb
Para execução em nuvem TestMu AI, veja reference/cloud-integration.md e shared/testmu-cloud-reference.md.
Padrões Principais
Teste Básico (Spock)
import geb.spock.GebSpec
class LoginSpec extends GebSpec {
def "login com credenciais válidas"() {
when:
to LoginPage
emailInput.value("[email protected]")
passwordInput.value("password123")
loginButton.click()
then:
at DashboardPage
welcomeMessage.text().contains("Welcome")
}
def "login mostra erro para credenciais inválidas"() {
when:
to LoginPage
emailInput.value("[email protected]")
passwordInput.value("wrong")
loginButton.click()
then:
at LoginPage
errorMessage.displayed
errorMessage.text().contains("Invalid")
}
}
Page Objects
class LoginPage extends geb.Page {
static url = "/login"
static at = { title == "Login" }
static content = {
emailInput { $("#email") }
passwordInput { $("#password") }
loginButton { $("button[type='submit']") }
errorMessage(required: false) { $(".error") }
}
}
class DashboardPage extends geb.Page {
static url = "/dashboard"
static at = { $(".dashboard").displayed }
static content = {
welcomeMessage { $(".welcome") }
userName { $(".user-name") }
}
}
Navigator API
$("css-selector")
$("div", class: "active")
$("input", name: "email")
$("div.items li", 0) // Primeiro resultado
$("div.items li").size() // Contagem
// Ações
element.click()
element.value("texto")
element << "texto" // Adicionar texto
element.text()
element.displayed
element.@href // Atributo
Nuvem: driver = new RemoteWebDriver(new URL(gridUrl), caps)
Configuração: Gradle com dependências geb-spock e selenium-support
Execução em Nuvem no TestMu AI
Defina as variáveis de ambiente: LT_USERNAME, LT_ACCESS_KEY
// GebConfig.groovy
environments {
lambdatest {
driver = {
def ltOptions = [
user: System.getenv("LT_USERNAME"),
accessKey: System.getenv("LT_ACCESS_KEY"),
build: "Geb Build",
name: "Geb Test",
platformName: "Windows 11",
video: true,
console: true,
network: true,
]
def caps = new ChromeOptions()
caps.setCapability("LT:Options", ltOptions)
new RemoteWebDriver(
new URL("https://hub.lambdatest.com/wd/hub"), caps)
}
}
}
Execute: ./gradlew test -Dgeb.env=lambdatest
Execute: ./gradlew test
Padrões Avançados
Veja reference/playbook.md para padrões de nível de produção:
| Seção | O Que Você Obtém |
|---|---|
| §1 Configuração do Projeto | build.gradle, GebConfig.groovy, ambientes, configuração de espera |
| §2 Page Objects | Content DSL, verificações at, módulos para componentes reutilizáveis |
| §3 Testes Spec | Integração Spock, testes orientados a dados com @Unroll, fluxos @Stepwise |
| §4 Espera e Assíncrono | Predefinições de espera, interação com JavaScript, alertas/confirmações |
| §5 Padrões Avançados | Upload/download de arquivos, janelas, iframes, extensões personalizadas |
| §6 Testes de API | Especificações de API REST com Groovy JsonSlurper |
| §7 Integração CI/CD | GitHub Actions com Chrome headless, cache Gradle |
| §8 Tabela de Depuração | 12 problemas comuns com causas e correções |
| §9 Melhores Práticas | Checklist de 14 itens para testes Geb |