============================================== go-selenium - Selenium WebDriver client for Go
go-selenium is a Selenium WebDriver client for Go.
Note: the public API is experimental and subject to change until further notice.
Usage
Documentation: go-selenium on Sourcegraph.
Example: see example_test.go:
package selenium_test
import (
"fmt"
"sourcegraph.com/sourcegraph/go-selenium"
)
func ExampleFindElement() {
var webDriver selenium.WebDriver
var err error
caps := selenium.Capabilities(map[string]interface{}{"browserName": "firefox"})
if webDriver, err = selenium.NewRemote(caps, "http://localhost:4444/wd/hub"); err != nil {
fmt.Printf("Failed to open session: %s\n", err)
return
}
defer webDriver.Quit()
err = webDriver.Get("https://sourcegraph.com/sourcegraph/go-selenium")
if err != nil {
fmt.Printf("Failed to load page: %s\n", err)
return
}
if title, err := webDriver.Title(); err == nil {
fmt.Printf("Page title: %s\n", title)
} else {
fmt.Printf("Failed to get page title: %s", err)
return
}
var elem selenium.WebElement
elem, err = webDriver.FindElement(selenium.ByCSSSelector, ".repo .name")
if err != nil {
fmt.Printf("Failed to find element: %s\n", err)
return
}
if text, err := elem.Text(); err == nil {
fmt.Printf("Repository: %s\n", text)
} else {
fmt.Printf("Failed to get text of element: %s\n", err)
return
}
// output:
// Page title: go-selenium - Sourcegraph
// Repository: go-selenium
}
The WebDriverT and WebElementT interfaces make test code cleaner. Each method in WebDriver and WebElement has a corresponding method in the *T interfaces that omits the error from the return values and instead calls t.Fatalf upon encountering an error. For example:
package mytest
import (
"sourcegraph.com/sourcegraph/go-selenium"
"testing"
)
var caps selenium.Capabilities
var executorURL = "http://localhost:4444/wd/hub"
// An example test using the WebDriverT and WebElementT interfaces. If you use the non-*T
// interfaces, you must perform error checking that is tangential to what you are testing,
// and you have to destructure results from method calls.
func TestWithT(t *testing.T) {
wd, _ := selenium.NewRemote(caps, executor)
// Call .T(t) to obtain a WebDriverT from a WebDriver (or to obtain a WebElementT from
// a WebElement).
wdt := wd.T(t)
// Calls `t.Fatalf("Get: %s", err)` upon failure.
wdt.Get("http://example.com")
// Calls `t.Fatalf("FindElement(by=%q, value=%q): %s", by, value, err)` upon failure.
elem := wdt.FindElement(selenium.ByCSSSelector, ".foo")
// Calls `t.Fatalf("Text: %s", err)` if the `.Text()` call fails.
if elem.Text() != "bar" {
t.Fatalf("want elem text %q, got %q", "bar", elem.Text())
}
}
See remote_test.go for more usage examples.
Running tests
Start Selenium WebDriver and run go test. To see all available options, run go test -test.h.
TODO
- Support Firefox profiles
Contributors
- Quinn Slack [email protected]
- Miki Tebeka [email protected] (go-selenium is based on Miki's github.com/tebeka/selenium library)
License
go-selenium is distributed under the Eclipse Public License.
![Screenshot() returning io.Reader instead of byte[]](https://avatars.githubusercontent.com/u/18521022?v=4)
0 Nov 6, 2021
47 Sep 28, 2022
123 Oct 27, 2022
17 Nov 18, 2022
15 Nov 7, 2022
2.3k Dec 28, 2022
7.1k Jan 9, 2023
75 Nov 16, 2022
5 Feb 4, 2022
30 Dec 12, 2022
9 Jul 2, 2022
3 Nov 23, 2022
2 Dec 14, 2021
570 Jan 1, 2023
8 Jan 21, 2022
0 Feb 10, 2022
1 Jun 4, 2022
42 Aug 11, 2022
6 Oct 23, 2022