agouti.go

// Package agouti is a universal WebDriver client for Go.
// It extends the api package to provide a feature-rich interface for
// controlling a web browser.
package agouti

import "fmt"

// PhantomJS returns an instance of a PhantomJS WebDriver.
// The RejectInvalidSSL Option must be provided to this PhantomJS function
// (and not the NewPage method) for this Option to take effect on any
// PhantomJS page.
func PhantomJS(options ...Option) *WebDriver {
	command := []string{"phantomjs", "--webdriver={{.Address}}"}
	defaultOptions := config{}.merge(options)
	if !defaultOptions.rejectInvalidSSL {
		command = append(command, "--ignore-ssl-errors=true")
	}
	return NewWebDriver("http://{{.Address}}", command, options...)
}

// ChromeDriver returns an instance of a ChromeDriver WebDriver.
// Provided Options will apply as default arguments for new pages.
// New pages will accept invalid SSL certificates by default. This
// may be disabled using the RejectInvalidSSL Option.
func ChromeDriver(options ...Option) *WebDriver {
	command := []string{"chromedriver", "--silent", "--port={{.Port}}"}
	return NewWebDriver("http://{{.Address}}", command, options...)
}

// Selenium returns an instance of a Selenium WebDriver.
// Provided Options will apply as default arguments for new pages.
// New pages will accept invalid SSL certificates by default. This
// may be disabled using the RejectInvalidSSL Option.
func Selenium(options ...Option) *WebDriver {
	command := []string{"selenium-server", "-port", "{{.Port}}"}
	return NewWebDriver("http://{{.Address}}/wd/hub", command, options...)
}

// SauceLabs opens a Sauce Labs session and returns a *Page. Does not support Sauce Connect.
func SauceLabs(name, platform, browser, version, username, accessKey string) (*Page, error) {
	url := fmt.Sprintf("http://%s:%s@ondemand.saucelabs.com/wd/hub", username, accessKey)
	capabilities := NewCapabilities().Browser(name).Platform(platform).Version(version)
	capabilities["name"] = name

	return NewPage(url, Desired(capabilities))
}