com.codeborne.selenide

Class WebDriverRunner

java.lang.Object

com.codeborne.selenide.WebDriverRunner

public class WebDriverRunner
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CHROME
static java.lang.String	FIREFOX
static java.lang.String	HTMLUNIT To use HtmlUnitDriver, you need to include extra dependency to your project: It's also possible to run HtmlUnit driver emulating different browsers:
static java.lang.String	INTERNET_EXPLORER
static java.lang.String	OPERA To use OperaDriver, you need to include extra dependency to your project: <dependency org="com.opera" name="operadriver" rev="1.5" conf="test->default"/>
static java.lang.String	PHANTOMJS To use PhantomJS, you need to include extra dependency to your project: <dependency org="com.github.detro.ghostdriver" name="phantomjsdriver" rev="1.+" conf="test->default"/>
static ScreenShotLaboratory	screenshots
static WebDriverThreadLocalContainer	webdriverContainer

Constructor Summary

Constructors

Constructor and Description
WebDriverRunner()

Method Summary

Methods

Modifier and Type	Method and Description
static void	addListener(org.openqa.selenium.support.events.WebDriverEventListener listener) Use this method BEFORE opening a browser to add custom event listeners to webdriver.
static void	clearBrowserCache() Delete all the browser cookies
static void	closeWebDriver() Close the browser if it's open
static org.openqa.selenium.WebDriver	getWebDriver() Get the underlying instance of Selenium WebDriver.
static boolean	htmlUnit() Is Selenide configured to use HtmlUnit browser
static boolean	ie() Is Selenide configured to use Internet Explorer browser
static boolean	isHeadless() Is Selenide configured to use headless browser (HtmlUnit or PhantomJS)
static boolean	phantomjs() Is Selenide configured to use PhantomJS browser
static void	setWebDriver(org.openqa.selenium.WebDriver webDriver) Tell Selenide use your provided WebDriver instance.
static java.lang.String	source()
static java.lang.String	takeScreenShot(java.lang.String fileName)
static java.lang.String	takeScreenShot(java.lang.String className, java.lang.String methodName)
static java.lang.String	url()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

webdriverContainer

public static WebDriverThreadLocalContainer webdriverContainer

screenshots

public static ScreenShotLaboratory screenshots

CHROME

public static final java.lang.String CHROME

See Also:

Constant Field Values

INTERNET_EXPLORER

public static final java.lang.String INTERNET_EXPLORER

See Also:

Constant Field Values

FIREFOX

public static final java.lang.String FIREFOX

See Also:

Constant Field Values

HTMLUNIT

public static final java.lang.String HTMLUNIT

To use HtmlUnitDriver, you need to include extra dependency to your project: It's also possible to run HtmlUnit driver emulating different browsers:

java -Dbrowser=htmlunit:firefox

java -Dbrowser=htmlunit:chrome

java -Dbrowser=htmlunit:internet explorer (default)

etc.

See Also:

Constant Field Values

PHANTOMJS

public static final java.lang.String PHANTOMJS

To use PhantomJS, you need to include extra dependency to your project: <dependency org="com.github.detro.ghostdriver" name="phantomjsdriver" rev="1.+" conf="test->default"/>

See Also:

Constant Field Values

OPERA

public static final java.lang.String OPERA

To use OperaDriver, you need to include extra dependency to your project: <dependency org="com.opera" name="operadriver" rev="1.5" conf="test->default"/>

See Also:

Constant Field Values

Constructor Detail

WebDriverRunner

public WebDriverRunner()

Method Detail

addListener

public static void addListener(org.openqa.selenium.support.events.WebDriverEventListener listener)

Use this method BEFORE opening a browser to add custom event listeners to webdriver.

Parameters:

listener - your listener of webdriver events

setWebDriver

public static void setWebDriver(org.openqa.selenium.WebDriver webDriver)

Tell Selenide use your provided WebDriver instance. Use it if you need a custom logic for creating WebDriver. It's recommended not to use implicit wait with this driver, because Selenide handles timing issues explicitly.

NB! Be sure to call this method before calling open(url). Otherwise Selenide will create its own WebDriver instance and would not close it.

P.S. Alternatively, you can run tests with system property

  -Dbrowser=com.my.WebDriverFactory

which should implement interface com.codeborne.selenide.WebDriverProvider

getWebDriver

public static org.openqa.selenium.WebDriver getWebDriver()

Get the underlying instance of Selenium WebDriver. This can be used for any operations directly with WebDriver.

closeWebDriver

public static void closeWebDriver()

Close the browser if it's open

ie

public static boolean ie()

Is Selenide configured to use Internet Explorer browser

isHeadless

public static boolean isHeadless()

Is Selenide configured to use headless browser (HtmlUnit or PhantomJS)

htmlUnit

public static boolean htmlUnit()

Is Selenide configured to use HtmlUnit browser

phantomjs

public static boolean phantomjs()

Is Selenide configured to use PhantomJS browser

clearBrowserCache

public static void clearBrowserCache()

Delete all the browser cookies

source

public static java.lang.String source()

Returns:

the source (HTML) of current page

url

public static java.lang.String url()

Returns:

the URL of current page

takeScreenShot

public static java.lang.String takeScreenShot(java.lang.String className,
                              java.lang.String methodName)

takeScreenShot

public static java.lang.String takeScreenShot(java.lang.String fileName)