WebDriver

Installation (Gradle)¶

implementation group: "org.http4k", name: "http4k-testing-webdriver", version: "4.7.0.1"

About¶

A basic Selenium WebDriver API implementation for http4k HttpHandlers, which runs completely out of container (no network) for ultra fast tests, backed by JSoup.

Feature	Supported	Notes
Navigation	yes	simple back/forward/refresh history
CSS selectors	yes
Link navigation	yes
Form field entry and submission	yes
Cookie storage	yes	manual expiry management
JavaScript	no
Alerts	no
Screenshots	no
Frames	no
Multiple windows	no

Use the API like any other WebDriver implementation, by simply passing your app HttpHandler to construct it. Note that we now support version 4 of the API, which has deprecated the old By implementations. http4k ships with a custom set of JSoup By implementations, so be sure to import org.http4k.webdriver.By instead of the old org.openqa.selenium.By ones (which will fail with a ClassCastException when used).

Code ¶

package guide.modules.webdriver

import org.http4k.core.Method.GET
import org.http4k.core.Response
import org.http4k.core.Status.Companion.OK
import org.http4k.routing.bind
import org.http4k.routing.routes
import org.http4k.webdriver.By
import org.http4k.webdriver.Http4kWebDriver

fun main() {
    val app = routes(
        "/hello" bind GET to {
            Response(OK).body("<html><title>hello</title></html>")
        }
    )

    val driver = Http4kWebDriver(app)

    driver.navigate().to("http://localhost:10000/hello")

    println(driver.title)

    // Note that we are using `org.http4k.webdriver.By`, as opposed to the ones from `org.openqa.selenium.By`
    println(driver.findElement(By.tagName("title")))

// prints:
//
// hello
// <title>hello</title>
}