WebSettings

Checks all mandatory settings.

Provides access to the gwen.target.browser setting used to set the target browser (default value is chrome). Valid values include chrome, firefox, safari, ie, and edge

Provides access to the gwen.target.env setting used to set the target environment (default value is local). Valid values include local, dev, test, staging, prod, or other user defined environment.

Provides access to the gwen.web.assertions.delayMillisecs setting used to control the delay time between initial and consecutive assertion attempts.

Provides access to the gwen.web.assertions.maxStrikes setting used to control the maximum number of times to retry failed assertions before timing out.

Provides access to the gwen.authorize.plugins setting used to control whether or not the browser should authorize browser plugins. (default value is false).

Provides access to the gwen.web.browser.headless setting used to control whether or not the browser should run headless. (default value is false).

Provides access to the gwen.web.browser.size setting used to set the browser window size. Expects value matching width x height (e:g 1200 x 800 for height 1200 and width 800). This setting is only applicable if the gwen.web.maximize is not set to true.

Provides access to the web capabilities settings. This setting merges a comma separated list of capabilities set in the gwen.web.capabilities property with all properties that start with gwen.web.capability.. See: https://github.com/SeleniumHQ/selenium/wiki/DesiredCapabilities

Provides access to the gwen.web.capture.screenshots.duplicates setting used to control whether or not the web driver should capture or discard contiguously duplicate screenshots (default value is false ~ to discard). If set to false, then a screenshot will be discarded if its size in bytes matches that of the last captured screenshot.

Provides access to the gwen.web.capture.screenshots.enabled setting used to control whether or not the web driver should capture screenshots for all steps (default value is false). Note that setting this to true degrades performance significantly. If the setting is true, then the gwen.report.slideshow.create setting is also implicitly set to true if it is not set so that the report generator in core web component knows to generate the slideshow.

Provides access to the gwen.web.capture.screenshots.highlighting setting used to control whether or not the web driver should capture screenshots for all steps that highlight elements on a page (default value is false). If the setting is true, then the gwen.report.slideshow.create setting is also implicitly set to true if it is not set so that the report generator in core web component knows to generate the slideshow. Note that setting this to true degrades performance significantly.

Provides access to the gwen.web.chrome.args setting used to set the list of Chrome web driver arguments to load (default is empty list). This setting merges a comma separated list of arguments set in the gwen.web.chrome.args property with all the value of all properties that start with gwen.web.chrome.args.. List of chrome arguments: https://peter.sh/experiments/chromium-command-line-switches

Provides access to the gwen.web.chrome.extensions settings use to set the list of Chrome web browser extensions to load (default is empty list). The settings accepts a comma separated list of paths to extensions (.crx files or location paths). Each extension provided is loaded into the Chrome web driver.

Provides access to the chrome mobile emulation settings. This setting merges a comma separated list of values set in the gwen.web.chrome.mobile property with all properties that start with gwen.web.chrome.mobile..

Provides access to the gwen.web.chrome.path setting used to specify the path to the Chrome browser binary. If not set, chromedriver will use the default system Chrome install. On macOS, this should be the actual binary, not just the app (e.g., /Applications/Google Chrome.app/Contents/MacOS/Google Chrome).

Provides access to the chrome preference settings. This setting merges a comma separated list of preferences set in the gwen.web.chrome.prefs property with all properties that start with gwen.web.chrome.pref.. List of chrome prefs: https://chromium.googlesource.com/chromium/src/+/master/chrome/common/pref_names.cc

Provides access to the gwen.web.selenium.manager setting used to determine the web driver manager implementation to use (default is SeleniumManager). Other option is WebDriverManager.

Provides access to the gwen.web.edge.args setting used to set the list of Edge web driver arguments to load (default is empty list). This setting merges a comma separated list of arguments set in the gwen.web.edge.args property with all the value of all properties that start with gwen.web.edge.args.. List of edge arguments: https://peter.sh/experiments/chromium-command-line-switches

Provides access to the gwen.web.edge.extensions settings use to set the list of Edge web browser extensions to load (default is empty list). The settings accepts a comma separated list of paths to extensions (.crx files or location paths). Each extension provided is loaded into the Edge web driver.

Provides access to the edge mobile emulation settings. This setting merges a comma separated list of values set in the gwen.web.edge.mobile property with all properties that start with gwen.web.edge.mobile..

Provides access to the gwen.web.edge.path setting used to specify the path to the Edge browser binary. If not set, edgedriver will use the default system Edge install.

Provides access to the edge preference settings. This setting merges a comma separated list of preferences set in the gwen.web.edge.prefs property with all properties that start with gwen.web.edge.pref.. List of edge prefs: https://chromium.googlesource.com/chromium/src/+/master/chrome/common/pref_names.cc

Provides access to the gwen.web.firefox.path setting used to specify the path to the Firefox browser binary. If not set, geckodriver will use the default system Firefox install. On macOS, this should be the actual binary, not just the app (e.g, /Applications/Firefox.app/Contents/MacOS/firefox).

Provides access to the firefox preference settings. This setting merges a comma separated list of preferences set in the gwen.web.firefox.prefs property with all properties that start with gwen.web.firefox.pref.. List of firefox prefs: https://stackoverflow.com/questions/25251583/downloading-file-to-specified-location-with-selenium-and-python

Provides access to the gwen.web.highlight.style setting used to control how elements are highlighted (default value is background: yellow; border: 2px solid gold;).

Provides access to the gwen.web.implicit.element.focus setting used to determine whether or not Gwen should implicitly put the focus on all located web elements. Default value is true.

Provides access to the gwen.web.implicit.element.moveTo setting used to determine whether or not Gwen should implicitly move to all located web elements. Default value is false.

Provides access to the gwen.web.implicit.js.locators setting used to determine whether or not Gwen should implicitly convert all locator bindings to JavaScript equivalents to force all elements to be located by executing javascript on the page. Default value is false.

Provides access to the gwen.web.locator.wait.seconds setting used to set the implicit locator wait/timeout time in the web driver (default is gwen.web.wait.seconds seconds).

Provides access to the gwen.web.maximize setting used to control whether or not the web driver should maximize the browser window (default value is false).

If set, enables the local file detector on remote webdriver if gwen.web.remote.url is set (default is disabled).

If set, allows gwen-web to connect to a remote webdriver.

Provides access to the gwen.web.sendKeys.clearFirst setting used to control whether or not Gwen will clear fields before sending keys to them. (default value is false).

Provides access to the gwen.web.sendKeys.clickFirst setting used to control whether or not Gwen will click fields before sending keys to them. (default value is false).

Provides access to the gwen.web.suppress.images setting used to control whether or not image rendering will be suppressed in the browser (default value is false). Currently this capability is only supported in firefox driver.

Provides access to the gwen.web.throttle.msecs setting used to control the wait between javascript evaluations and duration of element highlighting (default value is 100 msecs).

Provides access to the gwen.web.useragent setting used to set the user agent header in the browser (currently only supported for firefox and chrome).

Provides access to the gwen.web.wait.seconds setting used to set the implicit timeout/wait time in the web driver (default is 10 seconds). This value is also used as the default for gwen.web.locator.wait.seconds.

Chrome driver setting.

Edge driver setting.

Gecko (firefox) driver setting.

IE driver setting.