This is a Selenium client for Go. It supports the WebDriver protocol and has been tested on Selenium WebDriver and ChromeDriver.

selenium is currently maintained by Eric Garrido (@minusnine).

Run

go get github.com/tebeka/selenium

Docs are at https://godoc.org/github.com/tebeka/selenium

GetHTTPClient exposes the HTTP client used by the driver. You can access it to add the request context.

func myRequestHandler(w http.ResponseWriter, r *http.Request) {
    selenium.GetHTTPClient().Transport = &urlfetch.Transport{
        Context:  appengine.NewContext(r),
        Deadline: 30 * time.Second,
    }
    ...
}

Thanks to bthomson for this one.

• Finish full Selenium API.
• Test with Selenium WebDriver 3.0
• SauceLabs integration
• Add usage examples
• Support Firefox profiles
• Implement types that provide all capabilities.

Patches are encouraged through GitHub pull requests. Please ensure that a test is added for anything more than a trivial change and that the existing tests pass.

First, download the ChromeDriver binary and the Selenium WebDriver JARs:

$ cd vendor
$ go run init.go
$ cd ..

You only have to do this once.

Ensure that you have a firefox and a chromium binary in your path. If the binaries are named differently, run the tests with the flags --firefox_binary=<binary name> and/or --chrome_binary=<binary name> as appropriate.

Run the tests:

$ go test 

• There is one top-level test per browser (Chromium and ChromeDriver, and Firefox and Selenium). There are subtests that are shared between both top-level tests.
• To run only one of the top-level tests, pass -test.run=TestFirefox or -test.run=TestChrome. To run a specific subtest, pass -test.run=Test<Browser>/<subtest> as appropriate.
• If the chromium or firefox binaries, the Selenium JAR, or the ChromeDriver binary cannot be found, the corresponding tests will be skipped.
• The binaries and JAR under test can be configured by passing flags to go test. See the available flags with go test --arg --help.
• Add the argument -test.v to see the output from Selenium.

You will need an installed and running Docker system.

To run the tests under Docker, run:

$ go test --docker

This will create a new Docker container and run the tests in it. (Note: flags supplied to this invocation are not curried to the go test invocation within the Docker container).

This project is licensed under the MIT license.