Configuration (selenide 4.12.1 API)

java.lang.Object
- com.codeborne.selenide.Configuration

public class Configuration
extends java.lang.Object

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Configuration.AssertionMode` Assertion modes available
`static class`	`Configuration.FileDownloadMode`
`static class`	`Configuration.SelectorMode`

Field Summary

Fields
Modifier and Type	Field and Description
`static Configuration.AssertionMode`	`assertionMode` Assertion mode - STRICT or SOFT Asserts Default value: STRICT
`static java.lang.String`	`baseUrl` Base url for open() function calls Can be configured either programmatically or by system property "-Dselenide.baseUrl=http://myhost".
`static java.lang.String`	`browser` Which browser to use.
`static java.lang.String`	`browserBinary` Sets the path to browser executable.
`static org.openqa.selenium.remote.DesiredCapabilities`	`browserCapabilities` Browser capabilities.
`static java.lang.String`	`browserPosition` The browser window position on screen.
`static java.lang.String`	`browserSize` The browser window size.
`static java.lang.String`	`browserVersion` Which browser version to use (for Internet Explorer).
`static boolean`	`captureJavascriptErrors` Defines if Selenide tries to capture JS errors Can be configured either programmatically or by system property "-Dselenide.captureJavascriptErrors=false".
`static java.lang.String`	`chromeSwitches` Deprecated. this options allowed only a single switch. Please use instead more generic -Dchromeoptions.args= or use -Dchromeoptions.prefs= Value of "chrome.switches" parameter (in case of using Chrome driver). Can be configured either programmatically or by system property, i.e. "-Dselenide.chrome.switches=--disable-popup-blocking". Default value: none
`static boolean`	`clickViaJs` ATTENTION! Automatic WebDriver waiting after click isn't working in case of using this feature.
`static long`	`closeBrowserTimeoutMs` Timeout (in milliseconds) for closing/killing browser.
`static long`	`collectionsPollingInterval` Interval in milliseconds, when checking if a new collection elements appeared Can be configured either programmatically or by system property "-Dselenide.collectionsPollingInterval=150" Default value: 200 (milliseconds)
`static long`	`collectionsTimeout` Timeout in milliseconds for a collection to get completely loaded Conditions will be checked at this point at latest, even if they are still loading Can be configured either programmatically or by system property "-Dselenide.collectionsTimeout=10000" Default value: 6000 (milliseconds)
`static boolean`	`dismissModalDialogs` Mock "alert" and "confirm" javascript dialogs.
`static boolean`	`driverManagerEnabled` Controls Selenide and WebDriverManager integration.
`static boolean`	`fastSetValue` If set to true, sets value by javascript instead of using Selenium built-in "sendKey" function (that is quite slow because it sends every character separately).
`static Configuration.FileDownloadMode`	`fileDownload` Defines if files are downloaded via direct HTTP or vie selenide emebedded proxy server Can be configured either programmatically or by system property "-Dselenide.fileDownload=PROXY" Default: HTTPGET
`static boolean`	`headless` Enables the ability to run the browser in headless mode.
`static boolean`	`holdBrowserOpen` If holdBrowserOpen is true, browser window stays open after running tests.
`static long`	`openBrowserTimeoutMs` Timeout (in milliseconds) for opening (creating) a browser (webdriver).
`static java.lang.String`	`pageLoadStrategy` Should webdriver wait until page is completely loaded.
`static long`	`pollingInterval` Interval in milliseconds, when checking if a single element is appeared Can be configured either programmatically or by system property "-Dselenide.pollingInterval=50" Default value: 100 (milliseconds)
`static java.lang.String`	`remote` URL of remote web driver (in case of using Selenium Grid).
`static boolean`	`reopenBrowserOnFail` Should Selenide re-spawn browser if it's disappeared (hangs, broken, unexpectedly closed).
`static java.lang.String`	`reportsFolder` Folder to store screenshots to.
`static java.lang.String`	`reportsUrl` Optional: URL of CI server where reports are published to.
`static boolean`	`savePageSource` Defines if Selenide saves page source on failing tests.
`static boolean`	`screenshots` Defines if Selenide takes screenshots on failing tests.
`static Configuration.SelectorMode`	`selectorMode` Choose how Selenide should retrieve web elements: using default CSS or Sizzle (CSS3)
`static boolean`	`setValueChangeEvent` If set to true, 'setValue' and 'val' methods of SelenideElement trigger changeEvent after main manipulations.
`static boolean`	`startMaximized` The browser window is maximized when started.
`static long`	`timeout` Timeout in milliseconds to fail the test, if conditions still not met Can be configured either programmatically or by system property "-Dselenide.timeout=10000" Default value: 4000 (milliseconds)
`static boolean`	`versatileSetValue` If set to true, 'setValue' and 'val' methods of SelenideElement can work as 'selectOptionByValue', 'selectRadio' depending on the real control type, defined by element's tag.

Constructor Summary

Constructors
Constructor and Description

Configuration()

Constructors
Constructor and Description
`Configuration()`

Method Summary
- Methods inherited from class java.lang.Object
  clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - baseUrl
```
public static java.lang.String baseUrl
```
    Base url for open() function calls Can be configured either programmatically or by system property "-Dselenide.baseUrl=http://myhost". Default value: http://localhost:8080
  - collectionsTimeout
```
public static long collectionsTimeout
```
    Timeout in milliseconds for a collection to get completely loaded Conditions will be checked at this point at latest, even if they are still loading Can be configured either programmatically or by system property "-Dselenide.collectionsTimeout=10000" Default value: 6000 (milliseconds)
  - timeout
```
public static long timeout
```
    Timeout in milliseconds to fail the test, if conditions still not met Can be configured either programmatically or by system property "-Dselenide.timeout=10000" Default value: 4000 (milliseconds)
  - pollingInterval
```
public static long pollingInterval
```
    Interval in milliseconds, when checking if a single element is appeared Can be configured either programmatically or by system property "-Dselenide.pollingInterval=50" Default value: 100 (milliseconds)
  - collectionsPollingInterval
```
public static long collectionsPollingInterval
```
    Interval in milliseconds, when checking if a new collection elements appeared Can be configured either programmatically or by system property "-Dselenide.collectionsPollingInterval=150" Default value: 200 (milliseconds)
  - holdBrowserOpen
```
public static boolean holdBrowserOpen
```
    If holdBrowserOpen is true, browser window stays open after running tests. It may be useful for debugging. Can be configured either programmatically or by system property "-Dselenide.holdBrowserOpen=true".
    Default value: false.
  - reopenBrowserOnFail
```
public static boolean reopenBrowserOnFail
```
    Should Selenide re-spawn browser if it's disappeared (hangs, broken, unexpectedly closed).
    Can be configured either programmatically or by system property "-Dselenide.reopenBrowserOnFail=false".
    Default value: true Set this property to false if you want to disable automatic re-spawning the browser.
  - openBrowserTimeoutMs
```
public static long openBrowserTimeoutMs
```
    Timeout (in milliseconds) for opening (creating) a browser (webdriver).
    Can be configured either programmatically or by system property "-Dselenide.openBrowserTimeout=10000" Default value: 15000 (milliseconds)
  - closeBrowserTimeoutMs
```
public static long closeBrowserTimeoutMs
```
    Timeout (in milliseconds) for closing/killing browser.
    Sometimes we have problems with calling driver.close() or driver.quit() method, and test always is suspended too long.
    Can be configured either programmatically or by system property "-Dselenide.closeBrowserTimeout=10000" Default value: 5000 (milliseconds)
  - browser
```
public static java.lang.String browser
```
    Which browser to use. Can be configured either programmatically or by system property "-Dselenide.browser=ie" or "-Dbrowser=ie". Supported values: "chrome", "firefox", "legacy_firefox", "ie", "htmlunit", "phantomjs", "opera", "safari", "edge", "jbrowser"
    Default value: "firefox"
  - browserVersion
```
public static java.lang.String browserVersion
```
    Which browser version to use (for Internet Explorer). Can be configured either programmatically or by system property "-Dselenide.browserVersion=8" or "-Dbrowser.version=8".
    Default value: none
  - remote
```
public static java.lang.String remote
```
    URL of remote web driver (in case of using Selenium Grid). Can be configured either programmatically or by system property "-Dremote=http://localhost:5678/wd/hub". Default value: null (Grid is not used).
  - browserSize
```
public static java.lang.String browserSize
```
    The browser window size. Can be configured either programmatically or by system property "-Dselenide.browserSize=1024x768". Default value: none (browser size will not be set explicitly)
  - browserPosition
```
public static java.lang.String browserPosition
```
    The browser window position on screen. Can be configured either programmatically or by system property "-Dselenide.browserPosition=10x10". Default value: none (browser window position will not be set explicitly)
  - startMaximized
```
public static boolean startMaximized
```
    The browser window is maximized when started. Can be configured either programmatically or by system property "-Dselenide.startMaximized=true".
    Default value: true
  - chromeSwitches
```
@Deprecated
public static java.lang.String chromeSwitches
```
    Deprecated. this options allowed only a single switch. Please use instead more generic -Dchromeoptions.args=
    or use -Dchromeoptions.prefs=
    Value of "chrome.switches" parameter (in case of using Chrome driver). Can be configured either programmatically or by system property, i.e. "-Dselenide.chrome.switches=--disable-popup-blocking". Default value: none
  - browserCapabilities
```
public static org.openqa.selenium.remote.DesiredCapabilities browserCapabilities
```
    Browser capabilities. Warning: this capabilities will override capabilities were set by system properties.
    Default value: null
  - pageLoadStrategy
```
public static java.lang.String pageLoadStrategy
```
    Should webdriver wait until page is completely loaded. Possible values: "none", "normal" and "eager". Can be configured either programmatically or by system property "-Dselenide.pageLoadStrategy=eager". Default value: "normal". - `normal`: return after the load event fires on the new page (it's default in Selenium webdriver); - `eager`: return after DOMContentLoaded fires; - `none`: return immediately In some cases `eager` can bring performance boosts for the slow tests. Though, we left default value `normal` because we afraid to break users' existing tests. See https://w3c.github.io/webdriver/webdriver-spec.html#dfn-page-loading-strategy
    
    Since:
    
    3.5
  - clickViaJs
```
public static boolean clickViaJs
```
    ATTENTION! Automatic WebDriver waiting after click isn't working in case of using this feature. Use clicking via JavaScript instead common element clicking. This solution may be helpful for testing in Internet Explorer. Can be configured either programmatically or by system property "-Dselenide.clickViaJs=true". Default value: false
  - captureJavascriptErrors
```
public static boolean captureJavascriptErrors
```
    Defines if Selenide tries to capture JS errors Can be configured either programmatically or by system property "-Dselenide.captureJavascriptErrors=false". Default value: true
  - screenshots
```
public static boolean screenshots
```
    Defines if Selenide takes screenshots on failing tests. Can be configured either programmatically or by system property "-Dselenide.screenshots=false". Default value: true
  - savePageSource
```
public static boolean savePageSource
```
    Defines if Selenide saves page source on failing tests. Can be configured either programmatically or by system property "-Dselenide.savePageSource=false". Default value: true
  - reportsFolder
```
public static java.lang.String reportsFolder
```
    Folder to store screenshots to. Can be configured either programmatically or by system property "-Dselenide.reportsFolder=test-result/reports". Default value: "build/reports/tests" (this is default for Gradle projects)
  - reportsUrl
```
public static java.lang.String reportsUrl
```
    Optional: URL of CI server where reports are published to. In case of Jenkins, it is "BUILD_URL/artifact" by default. Can be configured either programmatically or by system property "-Dselenide.reportsUrl=http://jenkins-host/reports". If it's given, names of screenshots are printed as "http://ci.mycompany.com/job/my-job/446/artifact/build/reports/tests/my_test.png" - it's useful to analyze test failures in CI server.
  - dismissModalDialogs
```
public static boolean dismissModalDialogs
```
    Mock "alert" and "confirm" javascript dialogs. Can be configured either programmatically or by system property "-Dselenide.dismissModalDialogs=true". Default value: false (true for headless browsers like HtmlUnit and PhantomJS because they do not support alert/confirm anyway)
  - fastSetValue
```
public static boolean fastSetValue
```
    If set to true, sets value by javascript instead of using Selenium built-in "sendKey" function (that is quite slow because it sends every character separately). Tested on Codeborne projects - works well, speed up ~30%. Some people reported 150% speedup (because sending characters one-by-one was especially slow via network to Selenium Grid on cloud). https://github.com/codeborne/selenide/issues/135 Can be configured either programmatically or by system property "-Dselenide.fastSetValue=true". Default value: false
  - versatileSetValue
```
public static boolean versatileSetValue
```
    If set to true, 'setValue' and 'val' methods of SelenideElement can work as 'selectOptionByValue', 'selectRadio' depending on the real control type, defined by element's tag. Will decrease performance of setValue, make it slower, but will also make tests implementation more "business oriented". With this property being set to true, tests may no longer be dependent on actual control implementation in html and be more abstract. https://github.com/codeborne/selenide/issues/508 Can be configured either programmatically or by system property "-Dselenide.versatileSetValue=true". Default value: false
  - setValueChangeEvent
```
public static boolean setValueChangeEvent
```
    If set to true, 'setValue' and 'val' methods of SelenideElement trigger changeEvent after main manipulations. Firing change event is not natural and could lead to unpredictable results. Browser fires this event automatically according to web driver actions. Recommended behaviour is to disable this option. Make its true by default for backward compatibility. Can be configured either programmatically or by system property "-Dselenide.setValueChangeEvent=true". Default value: true
  - selectorMode
```
public static Configuration.SelectorMode selectorMode
```
    Choose how Selenide should retrieve web elements: using default CSS or Sizzle (CSS3)
  - assertionMode
```
public static Configuration.AssertionMode assertionMode
```
    Assertion mode - STRICT or SOFT Asserts Default value: STRICT
    
    See Also:
    
    Configuration.AssertionMode
  - fileDownload
```
public static Configuration.FileDownloadMode fileDownload
```
    Defines if files are downloaded via direct HTTP or vie selenide emebedded proxy server Can be configured either programmatically or by system property "-Dselenide.fileDownload=PROXY" Default: HTTPGET
  - driverManagerEnabled
```
public static boolean driverManagerEnabled
```
    Controls Selenide and WebDriverManager integration. When integration is enabled you don't need to download and setup any browser driver executables. See https://github.com/bonigarcia/webdrivermanager for WebDriverManager configuration details. Default: true
  - headless
```
public static boolean headless
```
    Enables the ability to run the browser in headless mode. Works only for Chrome(59+) and Firefox(56+). Default: false
  - browserBinary
```
public static java.lang.String browserBinary
```
    Sets the path to browser executable. Works only for Chrome, Firefox and Opera.
- Constructor Detail
  - Configuration
```
public Configuration()
```

Class Configuration

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

baseUrl

collectionsTimeout

timeout

pollingInterval

collectionsPollingInterval

holdBrowserOpen

reopenBrowserOnFail

openBrowserTimeoutMs

closeBrowserTimeoutMs

browser

browserVersion

remote

browserSize

browserPosition

startMaximized

chromeSwitches

browserCapabilities

pageLoadStrategy

clickViaJs

captureJavascriptErrors

screenshots

savePageSource

reportsFolder

reportsUrl

dismissModalDialogs

fastSetValue

versatileSetValue

setValueChangeEvent

selectorMode

assertionMode

fileDownload

driverManagerEnabled

headless

browserBinary

Constructor Detail

Configuration