WebDriverRunner (selenide 3.5.1 API)

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 set system property: -Dselenide.browser=phantomjs
`static java.lang.String`	`SAFARI` To use Safari webdriver, you need to include extra dependency to your project: <dependency org="org.seleniumhq.selenium" name="selenium-safari-driver" rev="2.+" conf="test->default"/>
`static WebDriverContainer`	`webdriverContainer`

Constructor Summary

Constructors
Constructor and Description

WebDriverRunner()

Constructors
Constructor and Description
`WebDriverRunner()`

Method Summary

All Methods Static Methods Concrete 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 java.lang.String`	`currentFrameUrl()`
`static org.openqa.selenium.WebDriver`	`getAndCheckWebDriver()` Get the underlying instance of Selenium WebDriver, and assert that it's still alive.
`static org.openqa.selenium.WebDriver`	`getWebDriver()` Get the underlying instance of Selenium WebDriver.
`static boolean`	`hasWebDriverStarted()`
`static boolean`	`isChrome()` Is Selenide configured to use Chrome browser
`static boolean`	`isFirefox()` Is Selenide configured to use Firefox browser
`static boolean`	`isHeadless()` Is Selenide configured to use headless browser (HtmlUnit or PhantomJS)
`static boolean`	`isHtmlUnit()` Is Selenide configured to use HtmlUnit browser
`static boolean`	`isIE()` Is Selenide configured to use Internet Explorer browser
`static boolean`	`isOpera()` Is Selenide configured to use Opera browser
`static boolean`	`isPhantomjs()` Is Selenide configured to use PhantomJS browser
`static boolean`	`isSafari()` Is Selenide configured to user Safari browser
`static void`	`setProxy(org.openqa.selenium.Proxy webProxy)` Sets Selenium Proxy instance
`static void`	`setWebDriver(org.openqa.selenium.WebDriver webDriver)` Tell Selenide use your provided WebDriver instance.
`static java.lang.String`	`source()`
`static boolean`	`supportsModalDialogs()` Does this browser support "alert" and "confirm" dialogs.
`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 WebDriverContainer webdriverContainer
```
  - 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
  - SAFARI
```
public static final java.lang.String SAFARI
```
    To use Safari webdriver, you need to include extra dependency to your project: <dependency org="org.seleniumhq.selenium" name="selenium-safari-driver" rev="2.+" conf="test->default"/>
    
    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 set system property: -Dselenide.browser=phantomjs
    
    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.
    NB! When using your custom webdriver, you are responsible for closing it. Selenide will not take care of it.
    
    NB! Webdriver instance should be created and used in the same thread. A typical error is to create webdriver instance in one thread and use it in another. Selenide does not support it. If you really need using multiple threads, please use #com.codeborne.selenide.WebDriverProvider
    
    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.
  - setProxy
```
public static void setProxy(org.openqa.selenium.Proxy webProxy)
```
    Sets Selenium Proxy instance
    
    Parameters:
    
    webProxy -
  - getAndCheckWebDriver
```
public static org.openqa.selenium.WebDriver getAndCheckWebDriver()
```
    Get the underlying instance of Selenium WebDriver, and assert that it's still alive.
    
    Returns:
    
    new instance of WebDriver if the previous one has been closed meanwhile.
  - closeWebDriver
```
public static void closeWebDriver()
```
    Close the browser if it's open
  - hasWebDriverStarted
```
public static boolean hasWebDriverStarted()
```
    Returns:
    
    true iff instance of Selenium WebDriver is started in current thread
  - isFirefox
```
public static boolean isFirefox()
```
    Is Selenide configured to use Firefox browser
  - isChrome
```
public static boolean isChrome()
```
    Is Selenide configured to use Chrome browser
  - isIE
```
public static boolean isIE()
```
    Is Selenide configured to use Internet Explorer browser
  - isSafari
```
public static boolean isSafari()
```
    Is Selenide configured to user Safari browser
  - isHeadless
```
public static boolean isHeadless()
```
    Is Selenide configured to use headless browser (HtmlUnit or PhantomJS)
  - supportsModalDialogs
```
public static boolean supportsModalDialogs()
```
    Does this browser support "alert" and "confirm" dialogs.
  - isHtmlUnit
```
public static boolean isHtmlUnit()
```
    Is Selenide configured to use HtmlUnit browser
  - isPhantomjs
```
public static boolean isPhantomjs()
```
    Is Selenide configured to use PhantomJS browser
  - isOpera
```
public static boolean isOpera()
```
    Is Selenide configured to use Opera 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
  - currentFrameUrl
```
public static java.lang.String currentFrameUrl()
```
    Returns:
    
    the URL of current frame

Class WebDriverRunner

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

webdriverContainer

CHROME

INTERNET_EXPLORER

FIREFOX

SAFARI

HTMLUNIT

PHANTOMJS

OPERA

Constructor Detail

WebDriverRunner

Method Detail

addListener

setWebDriver

getWebDriver

setProxy

getAndCheckWebDriver

closeWebDriver

hasWebDriverStarted

isFirefox

isChrome

isIE

isSafari

isHeadless

supportsModalDialogs

isHtmlUnit

isPhantomjs

isOpera

clearBrowserCache

source

url

currentFrameUrl