open-testing-convert-geb

name	open-testing-convert-geb
description	Convert Geb test suites — Groovy browser-automation DSL on Selenium. Parses `GebConfig.groovy`, `*.groovy` tests with `Browser.drive { ... }`, jQuery-like `$()` navigator, `GebSpec` / `GebReportingSpec` (Spock), `GebTest` (JUnit). Handles `Page` classes with `static url` / `static at` / `static content` closures, `Module` fragments, `waitFor`, page transitions (`to PageClass`, `via { click }`), form helpers (`$form.field = "v"`), Spock blocks (given/when/then/expect/where), `@Unroll` data-driven, Gradle `geb-spock` / `geb-junit5` deps, and environment driver switching. Targets: Selenium, Playwright, Cypress, WebDriverIO, Cucumber, Serenity, Eggplant, OpenTest.AI, Testers.AI. MANDATORY TRIGGERS: "convert Geb", "Geb to <target>", "gebish", "GebSpec", "GebConfig.groovy", "geb-spock".
license	MIT
metadata	{"family":"open-testing-convert","source":"geb","orchestrator":"open-testing-convert","targets":["selenium","playwright","cypress","webdriverio","puppeteer","appium","cucumber","eggplant","testcafe","nightwatch","codeceptjs","taiko","protractor","katalon","playwright-bdd","behave","specflow","behat","karate","robot-framework","gauge","serenity","opentestai","testersai-recorder","testersai-dynamic"]}

Convert — Geb

Converts Geb (Groovy browser automation on Selenium) to any supported target, and emits Geb from any source.

Geb's design is distinctive in three ways:

1. Groovy DSL on Selenium. Every test is Groovy code that compiles against Selenium WebDriver underneath. The public surface looks like jQuery ($("#id"), $("div.item:first").click()) but the runtime is Selenium.
2. Content DSL. Pages declare named content via closures: login { $("#login") }. The return type determines usage — Navigator by default, but Module subclasses add behaviour, and primitives (string, number) come from { $(".count").text() as int }-style closures.
3. Spock integration is the default. Production Geb suites almost always run on Spock — each test is a def "scenario"() { given: ... when: ... then: ... } feature method. JUnit4/5 and TestNG integrations exist but are rare.

When to use

Trigger when:

• GebConfig.groovy / GebConfig.properties present.
• org.gebish:geb-* dependency in Gradle/Maven.
• .groovy test files extending GebSpec, GebReportingSpec, GebTest, GebReportingTest.
• import geb.Page or import geb.Module in Groovy files.
• Groovy source with $() selector usage + waitFor blocks + to PageClass.
• CI step ./gradlew geb or ./gradlew test with Geb-specific config.

How to use

1. Read the master orchestrator first.
2. Read this skill's reference files: source-profile.md, extraction.md, mappings.md.
3. Read target primer for your target.
4. Emit per target Emission Checklist.

Scope

• Geb 5.x and 6.x. Semantic changes for Java 11+ baseline; syntax largely unchanged.
• Spock integration (GebSpec, GebReportingSpec) — primary.
• JUnit 4 (GebTest) and JUnit 5 (GebReportingTest) — secondary.
• TestNG (GebReportingTest with TestNG) — rare, but supported.
• Page Object hierarchy with static url, static at, static content closures.
• Module classes and module X content definitions.
• waitFor blocks, required content option, wait timeouts.
• Environments block in config (driver switching).
• Browser remote control pattern.
• Spock blocks: given/when/then/expect/and/where/cleanup/setup.
• @Stepwise Spock annotation.
• Data-driven Spock where: tables.
• Base URL resolution.
• at(PageClass) / to(PageClass) page navigation.
• jQuery-style selector chaining (.find(), .parent(), .first(), .last(), .next(), .prev()).
• Form field setters ($("input", name: "x").value("y"), page.fieldName = "y").

Out of scope

• geb-sauce / geb-browserstack config nuance — preserve config verbatim; no semantic extraction.
• Visual testing plugins for Geb — annotation only.
• Custom reporter implementations — preserve config; not extraction-semantic.
• Groovy AST transformations in test files — flag as warnings.
• Full Spock extension ecosystem (SpockHolm, etc.) — preserve @ annotations.

Quick reference

Geb construct	Canonical	Example target
to LoginPage	{kind: "navigate", url: LoginPage.url}	page.goto(url)
at LoginPage	{kind: "assert", assertion_kind: "at_page", page: "LoginPage"}	combined navigate+assert
$("input#email")	{locator: {strategy:"css", value:"input#email"}}
$("input", name: "email")	{locator: {strategy:"css", value:"input[name='email']"}}
$(".btn").click()	{kind: "click", locator}
$("#x").value("y")	{kind: "input", locator, value: "y"}
username = "alice" (field assignment on page)	{kind: "input", locator: content.username, value: "alice"}
waitFor { $(".done").displayed }	{kind: "wait_for", locator, assertion_kind: "element_visible"}
static content = { login { $("#login") } }	page.content_elements.login = locator	locator map
module HeaderModule { ... }	nested page-object structure	sub-page object
Spock then: title == "X"	{kind: "assert", assertion_kind: "title_equals", expected: "X"}
Spock where: table	data_driven: {columns, rows}	Scenario Outline

See reference/mappings.md for full cookbook.