Skip to main content

browser.yml

The browser.yml file defines the configuration of the browser that is created for your test run if you have selected it as a test type in config.yml.

source

nodejs
2021.1.0
ruby
2021.1.0
source: local

Specify where you want the browser to be created.

languagesourcedescription
RubyNodeJSlocalcreate a browser on the machine running the tests
RubyNodeJSbrowserstackcreate a browser using BrowserStack
Rubyperfectocreate a browser using Perfecto
RubyNodeJSsauce_labscreate a browser using Sauce Labs
RubyNodeJSkobitoncreate a browser using Kobiton
Rubylocal_devicecreate a browser on a device connected to the machine running the tests
Rubylambda_testcreate a browser using LambdaTest

default_timeout

nodejs
2021.1.0
ruby
2021.1.0
default_timeout: 10

Enter the number of seconds that the browser should wait to find an element on a page before failing the test.

implicit_wait

nodejs
2021.1.0
ruby
2021.1.0
implicit_wait: 0

Enter the number of seconds that the browser should implicitly wait before failing. Example: Searching for an element on the page and waiting for a script to complete.

page_load_timeout

nodejs
2021.1.0
ruby
2021.1.0
page_load_timeout: 10

Enter the number of seconds that the browser should wait for a page to load before failing the test.

same_browser

nodejs
2021.1.0
ruby
2021.1.0
same_browser: true

Reuse the same browser for all tests in your test run.

optiondescription
truereuses the currently open browser for all subsequent tests
falseopens a new instance of the configured browser at the start of each test

close_browser

nodejs
2021.1.0
ruby
2021.1.0
close_browser: true

Closes the browser once a test has completed, or after all tests are completed if same_browser is true.

optiondescription
truecloses the browser at the completion of a test
falseleaves the browser open at the completion of a test

clear_cookies

ruby
2021.1.0
clear_cookies: true

Deletes the cookies after each test is completed.

optiondescription
trueclears the cookies at the completion of a test
falsedoes not clear the cookies at the completion of a test

local

nodejs
2021.1.0
ruby
2021.1.0

If you have configured source to be local, then the local section defines the configuration for the browser to be created on the machine the test run is executed on.

platform

nodejs
2021.1.0
ruby
2021.1.0
platform: desktop

Specify if the browser is to be a desktop or mobile browser.

platformdescription
desktopbrowser is created with the configuration in the desktop section
mobilebrowser is created with the configuration in the mobile section

desktop

If you have configured platform to be desktop, then the desktop section defines the configuration for the desktop browser to be created on the machine the test run is executed on.

browser

nodejs
2021.1.0
ruby
2021.1.0
browser: chrome

Specify the desired browser type for the local test run.

languagebrowserdescription
RubyNodeJSchromechrome browser is opened locally using the configured chromedriver
RubyNodeJSfirefoxfirefox browser is opened locally using the configured geckodriver
RubyNodeJSsafarisafari browser is opened locally
RubyNodeJSedgeedge browser is opened locally

maximise

nodejs
2021.1.0
ruby
2021.1.0
maximise: true

Enable to maximise the browser once opened.

optiondescription
truemaximises the browser once opened
falsebrowser remains at the default size unless overridden by the resize option

resize

nodejs
2021.1.0
ruby
2021.1.0
resize: true

Enable to resize the browser to a specified breakpoint once opened.

optiondescription
trueresizes the browser to the breakpoint defined in the breakpoint section after it is opened
falsebrowser remains at the default size unless overridden by the maximise option

maximise and resize options cannot both be set to true. If they are both set to false then the browser will remain at the default size.

breakpoint

nodejs
2021.1.0
ruby
2021.1.0

If you have configured the local browser to resize then this section specifies the configuration of the size of the browser window.

width
width: 1024

The width to resize the browser window to in pixels.

height
height: 768

The height to resize the browser window to in pixels.

mobile

If you have configured platform to be mobile, then the mobile section defines the configuration for the emulated mobile browser to be created on the machine the test run is executed on.

browser

nodejs
2021.1.0
ruby
2021.1.0
browser: chrome

Specify the desired browser type for the local test run.

languagebrowserdescription
RubyNodeJSchromechrome browser is opened locally using the configured chromedriver
RubyNodeJSfirefoxfirefox browser is opened locally using the configured geckodriver
RubyNodeJSsafarisafari browser is opened locally

device

nodejs
2021.1.0
ruby
2021.1.0
device: iphone

Specify the device type for the browser to emulate in the local test run.

Please note - Test Evolve Spark users have different device types available to them depending on which browser they have selected.

For Firefox and Safari in Ruby and Firefox in Javascript, the following emulations are available:

optiondescription
iphoneemulate an iphone in the specified browser
ipademulate an ipad in the specified browser
android_phoneemulate an android phone in the specified browser
android_tabletemulate an android tablet in the specified browser

For Chrome in Ruby and Javascript, you can specify a particular device that Chrome will then emulate. As different versions of Chrome will support the emulation of different devices, follow the guide below to view the available devices for your version:

https://chromium.googlesource.com/chromium/src/+/167a7f5e03f8b9bd297d2663ec35affa0edd5076/third_party/WebKit/Source/devtools/front_end/emulated_devices/module.json

browserstack

nodejs
2021.1.0
ruby
2021.1.0

If you have configured source to be browserstack, then the browserstack section defines the configuration for the browser to be created on a Browserstack virtual machine or real device.

info

In order to use the Test Evolve BrowserStack integration you will need an account with BrowserStack. In order to create a browser using the following configuration you will also need to add a valid username and api key to the accounts.yml configuration file.

platform

nodejs
2021.1.0
ruby
2021.1.0
platform: desktop

Specify if the browser is to be a desktop or mobile browser.

platformdescription
desktopbrowser is created with the configuration in the desktop section
mobilebrowser is created with the configuration in the mobile section

local_testing

nodejs
2021.1.0
ruby
2021.1.0
local_testing: true

Use the BrowserStack binary to allow for testing of locally accessible environments.

For more information on how to setup the BrowserStack binary, visit: https://www.browserstack.com/local-testing

optiondescription
trueenables local testing using the BrowserStack binary. if the binary is not running on the machine running the tests, or it is misconfigured the test will fail
falsethe mobile app on the device in BrowserStack will only have access publicly accessible APIs

download_video_upon_failure

deprecated

Please remove this option from your configuration file.

browserstack_debug

nodejs
2021.1.0
ruby
2021.1.0
browserstack_debug: true

Enable the debug logs for the test in BrowserStack. These can be accessed via the BrowserStack dashboard.

optiondescription
trueenables debug logging
falsedisables debug logging

test_name

nodejs
2021.1.0
ruby
2021.1.0
test_name: Regression Tests

This identifier is referred to as Project name in BrowserStack and it can be used to easily identify the results in BrowserStack.

browserstack_options

nodejs
2021.1.6
ruby
2021.1.4
browserstack_options: []

Using this input array, you can now add any valid browserstack capability to configure your test run as required.

Valid capabilities for use in this options array can be found here: https://www.browserstack.com/automate/capabilities?tag=selenium-4

desktop

If you have configured platform to be desktop, then the desktop section defines the configuration for the desktop browser to be created by BrowserStack.

Available virtual machines can be found here: https://www.browserstack.com/list-of-browsers-and-platforms/automate

Available configurations can be found using the BrowserStack Capabilities Generator: https://www.browserstack.com/automate/capabilities. Select a desktop operating system and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

browser

nodejs
2021.1.0
ruby
2021.1.0
browser: Chrome

The browser to open in the BrowserStack session.

browser_version

nodejs
2021.1.0
ruby
2021.1.0
browser_version: 68

The version of the browser to open in the BrowserStack session.

platform

nodejs
2021.1.0
ruby
2021.1.0
platform: Windows

The OS of the virtual machine in the BrowserStack session.

platform_version

nodejs
2021.1.0
ruby
2021.1.0
platform_version: 7

The OS version of the virtual machine in the BrowserStack session.

resolution

nodejs
2021.1.0
ruby
2021.1.0
resolution: 1024x768

The resolution of the virtual machine in the BrowserStack session.

maximise

nodejs
2021.1.0
ruby
2021.1.0
maximise: true

Enable to maximise the browser once opened.

optiondescription
truemaximises the browser once opened
falsebrowser remains at the default size unless overridden by the resize option

resize

nodejs
2021.1.0
ruby
2021.1.0
resize: true

Enable to resize the browser to a specified breakpoint once opened.

optiondescription
trueresizes the browser to the breakpoint defined in the breakpoint section after it is opened
falsebrowser remains at the default size unless overridden by the maximise option

maximise and resize options cannot both be set to true. If they are both set to false then the browser will remain at the default size.

breakpoint

nodejs
2021.1.0
ruby
2021.1.0

If you have configured the local browser to resize then this section specifies the configuration of the size of the browser window.

width
width: 1024

The width to resize the browser window to in pixels.

height
height: 768

The height to resize the browser window to in pixels.

mobile

If you have configured platform to be mobile, then this section defines the configuration for the device and browser to run the tests against in BrowserStack.

Available mobile devices can be found here: https://www.browserstack.com/list-of-browsers-and-platforms/automate

Configurations can be found using the BrowserStack Capabilities Generator: https://www.browserstack.com/automate/capabilities. Select a mobile device and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

browser_name

nodejs
2021.1.0
ruby
2021.1.0
browser_name: Safari

The browser to open on the BrowserStack device.

platform

nodejs
2021.1.0
ruby
2021.1.0
platform: ANY

The OS of the BrowserStack device.

device

nodejs
2021.1.0
ruby
2021.1.0
device: iPhone 11 Pro

The name of the BrowserStack device.

os_version

nodejs
2021.1.0
ruby
2021.1.0
os_version: 13

The OS version of the BrowserStack device.

orientation

nodejs
2021.1.4
orientation: portrait

You can specify whether you want your mobile to be portrait or landscape.

perfecto

ruby
2021.1.0

If you have configured source to be perfecto, then the perfecto section defines the configuration for the browser to be created on a Perfecto virtual machine or real device.

info

In order to use the Test Evolve Perfecto integration you will need an account with Perfecto. In order to create a browser using the following configuration you will also need to add a valid username and api key to the accounts.yml configuration file.

platform

ruby
2021.1.0
platform: desktop

Specify if the browser is to be a desktop or mobile browser.

platformdescription
desktopbrowser is created with the configuration in the desktop section
mobilebrowser is created with the configuration in the mobile section

connection_timeout

ruby
2021.1.0
connection_timeout: 60

Enter the number of seconds to wait for activity in the remote browser before a connection timeout occurs.

desktop

ruby
2021.1.0

If you have configured platform to be desktop, then the desktop section defines the configuration for the desktop browser to be created by Perfecto.

Supported platforms can be found here: https://developers.perfectomobile.com/display/PD/Supported+platforms

platform

ruby
2021.1.0
platform: Windows

The OS of the virtual machine in the Perfecto session.

version

ruby
2021.1.0
version: 7

The OS version of the virtual machine in the Perfecto session.

browser

ruby
2021.1.0
browser: Internet Explorer

The browser to open in the Perfecto session.

browser_version

ruby
2021.1.0
browser_version: 10

The version of the browser to open in the Perfecto session.

resolution

ruby
2021.1.0
resolution: 1024x768

The resolution of the virtual machine in the Perfecto session.

location

ruby
2021.1.0
location: US East

The location of the Perfecto facility.

maximise

ruby
2021.1.0
maximise: true

Enable to maximise the browser once opened.

optiondescription
truemaximises the browser once opened
falsebrowser remains at the default size unless overridden by the resize option

resize

ruby
2021.1.0
resize: true

Enable to resize the browser to a specified breakpoint once opened.

optiondescription
trueresizes the browser to the breakpoint defined in the breakpoint section after it is opened
falsebrowser remains at the default size unless overridden by the maximise option

maximise and resize options cannot both be set to true. If they are both set to false then the browser will remain at the default size.

breakpoint

ruby
2021.1.0

If you have configured the local browser to resize then this section specifies the configuration of the size of the browser window.

width
width: 1024

The width to resize the browser window to in pixels.

height
height: 768

The height to resize the browser window to in pixels.

mobile

If you have configured platform to be mobile, then this section defines the configuration for the device and browser to run the tests against in Perfecto.

Available mobile devices can be found in realtime in your Perfecto dashboard.

device_id

ruby
2021.1.0
device_id: 123456789

The device to execute the automated tests against in Perfecto.

sauce_labs

nodejs
2021.1.7
ruby
2021.1.0

If you have configured source to be sauce_labs, then the sauce_labs section defines the configuration for the browser to be created on a Sauce Labs virtual machine or virtual device.

info

In order to use the Test Evolve Sauce Labs integration you will need an account with Sauce Labs. In order to create a browser using the following configuration you will also need to add a valid username and api key to the accounts.yml configuration file.

platform

nodejs
2021.1.7
ruby
2021.1.0
platform: desktop

Specify if the browser is to be a desktop or mobile browser.

platformdescription
desktopbrowser is created with the configuration in the desktop section
mobilebrowser is created with the configuration in the mobile section

test_name

nodejs
2021.1.7
ruby
2021.1.0
test_name: Regression Tests

Names the test session so that it can be easily identified when accessing the results in Sauce Labs.

desktop

If you have configured platform to be desktop, then the desktop section defines the configuration for the desktop browser to be created by Sauce Labs.

Available virtual machines can be found here: https://saucelabs.com/platform/supported-browsers-devices

Available configurations can be found using the Sauce Labs Platform Configurator: https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/. Select WebDriver (W3C) as the API and PC or Mac under device. Then select your preferred operating system and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

platform

nodejs
2021.1.7
ruby
2021.1.0
platform: Windows 7

The OS version of the virtual machine in the Sauce Labs session.

browser

nodejs
2021.1.7
ruby
2021.1.0
browser: Chrome

The browser to open in the Sauce Labs session.

browser_version

nodejs
2021.1.7
ruby
2021.1.0
browser_version: 68

The version of the browser to open in the Sauce Labs session.

resolution

nodejs
2021.1.7
ruby
2021.1.0
resolution: 1024x768

The resolution of the virtual machine in the Sauce Labs session.

maximise

nodejs
2021.1.7
ruby
2021.1.0
maximise: true

Enable to maximise the browser once opened.

optiondescription
truemaximises the browser once opened
falsebrowser remains at the default size unless overridden by the resize option

resize

nodejs
2021.1.7
ruby
2021.1.0
resize: true

Enable to resize the browser to a specified breakpoint once opened.

optiondescription
trueresizes the browser to the breakpoint defined in the breakpoint section after it is opened
falsebrowser remains at the default size unless overridden by the maximise option

maximise and resize options cannot both be set to true. If they are both set to false then the browser will remain at the default size.

breakpoint

nodejs
2021.1.7
ruby
2021.1.0

If you have configured the local browser to resize then this section specifies the configuration of the size of the browser window.

width
width: 1024

The width to resize the browser window to in pixels.

height
height: 768

The height to resize the browser window to in pixels.

mobile

If you have configured platform to be mobile, then this section defines the configuration for the device and browser to run the tests against in Sauce Labs.

Available virtual machines can be found here: https://saucelabs.com/platform/supported-browsers-devices

Available configurations can be found using the Sauce Labs Platform Configurator: https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/. Select Appium as the API and (depending on your subscription) an emulated or real device. Then select your preferred operating system and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

appium

nodejs
2021.1.7
ruby
2021.1.0
appium: 1.17.1

The version of Appium to use to connect to the Sauce Labs device.

device

nodejs
2021.1.7
ruby
2021.1.0
device: iPhone XS Simulator

The name of the Sauce Labs device.

orientation

nodejs
2021.1.7
ruby
2021.1.0
orientation: portrait

The desired orientation of the Sauce Labs device.

platform_name

nodejs
2021.1.7
ruby
2021.1.0
platform_name: iOS

The desired OS for the Sauce Labs device.

platform_version

nodejs
2021.1.7
ruby
2021.1.0
platform_version: 13.2

The version of the selected OS for the Sauce Labs device.

browser

nodejs
2021.1.7
ruby
2021.1.0
browser: Safari

The browser to open on the Sauce Labs device.

kobiton

nodejs
2021.1.4
ruby
2021.1.0

If you have configured source to be kobiton, then the kobiton section defines the configuration for the browser to be created on a Kobiton real device.

session_name

nodejs
2021.1.4
ruby
2021.1.0
session_name: Regression Tests

Names the test session so that it can be easily identified when accessing the results in Kobiton.

session_description

nodejs
2021.1.4
ruby
2021.1.0
session_description: To demonstrate the integrations of Test Evolve

Describes the test session so that it can be easily identified when accessing the results in Kobiton.

capture_screenshots

nodejs
2021.1.4
ruby
2021.1.0
capture_screenshots: false

Captures a screenshot and stores it against your test run in Kobiton.

optiondescription
truecaptures screenshots during the test execution
falsedoes not capture screenshots during the test execution

This does not affect any settings for locally saving screenshots on failure as set in reporting.yml

mobile

This section defines the configuration for the device and browser to run the tests against in Kobiton.

Available mobile devices can be found here: https://docs.kobiton.com/devices-list/. Select an operating system version and browser version to see the matching devices and add the values to the Test Evolve configuration.

device

nodejs
2021.1.4
ruby
2021.1.0
device: Pixel 2

The name of the Kobiton device.

orientation

nodejs
2021.1.4
ruby
2021.1.0
orientation: portrait

The orientation of the Kobiton device during test execution.

browser

nodejs
2021.1.4
ruby
2021.1.0
browser: Chrome

The browser to open on the Kobiton device.

platform_name

nodejs
2021.1.4
ruby
2021.1.0
platform: Android

The OS of the Kobiton device.

platform_version

nodejs
2021.1.4
ruby
2021.1.0
platform_version: 11

The OS version of the Kobiton device.

local_device

ruby
2021.1.0

If you have configured source to be local_device, then the local_device section defines the configuration for the browser to be created on a locally connected device.

command_timeout

ruby
2021.1.0
command_timeout: 60

Specify the timeout of the connection to the device in Appium.

appium_options

ruby
2022.1.0
appium_options: []

Using this input array, you can now add any valid appium capability to configure your test run as required.

mobile

local_device only has a mobile section in Test Evolve.

device_name

ruby
2021.1.0
device_name: iPhone X

Specify the name of the connected device to be used in the test run.

browser_name

ruby
2021.1.0
browser: chrome

Specify the name of the browser on the connected device to be used in the test run.

platform_name

ruby
2021.1.0
platform_name: Android

Specify the operating system on the connected device being used in the test run. This helps Appium select the correct driver to use to connect and manage the device.

platform_version

ruby
2021.1.0
platform_version: 10.0

Specify the operating system version on the connected device being used in the test run. This helps Appium select the correct driver to use to connect and manage the device.

udid

ruby
2021.1.0
udid: emulator-5554

Specify the udid of the connected device being used in the test run. There are different methods to finding this id in Android and iOS.

lambdatest

ruby
2024.1.1

If you have configured source to be lambda_test, then the lambda_test section defines the configuration for the browser to be created on a LambdaTest virtual machine or real device.

info

In order to use the Test Evolve LambdaTest integration you will need an account with LambdaTest. In order to create a browser using the following configuration you will also need to add a valid username and api key to the accounts.yml configuration file.

platform

ruby
2024.1.1
platform: desktop

Specify if the browser is to be a desktop or mobile browser.

platformdescription
desktopbrowser is created with the configuration in the desktop section
mobilebrowser is created with the configuration in the mobile section

lambda_test_options

ruby
2024.1.1
lambda_test_options: [ ]

Using this input array, you can now add any valid LambdaTest capability to configure your test run as required.

Valid capabilities for use in this options array can be found here: https://www.lambdatest.com/support/docs/selenium-automation-capabilities/

desktop

If you have configured platform to be desktop, then the desktop section defines the configuration for the desktop browser to be created by LambdaTest.

Available virtual machines can be found here: https://www.lambdatest.com/list-of-browsers

Available configurations can be found using the LambdaTest Capabilities Generator: https://www.lambdatest.com/capabilities-generator/. Select a desktop operating system and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

browser

ruby
2024.1.1
browser: Chrome

The browser to open in the LambdaTest session.

browser_version

ruby
2024.1.1
browser_version: 68

The version of the browser to open in the LambdaTest session.

platform

ruby
2024.1.1
platform: Windows

The OS of the virtual machine in the LambdaTest session.

maximise

ruby
2024.1.1
maximise: true

Enable to maximise the browser once opened.

optiondescription
truemaximises the browser once opened
falsebrowser remains at the default size unless overridden by the resize option

resize

ruby
2024.1.1
resize: true

Enable to resize the browser to a specified breakpoint once opened.

optiondescription
trueresizes the browser to the breakpoint defined in the breakpoint section after it is opened
falsebrowser remains at the default size unless overridden by the maximise option

maximise and resize options cannot both be set to true. If they are both set to false then the browser will remain at the default size.

breakpoint

ruby
2024.1.1

If you have configured the local browser to resize then this section specifies the configuration of the size of the browser window.

width
width: 1024

The width to resize the browser window to in pixels.

height
height: 768

The height to resize the browser window to in pixels.

mobile

If you have configured platform to be mobile, then this section defines the configuration for the device and browser to run the tests against in LambdaTest.

Available mobile devices can be found here: https://www.lambdatest.com/list-of-real-devices

Configurations can be found using the LambdaTest Capabilities Generator: https://www.lambdatest.com/capabilities-generator/. Select a mobile device and browser in the tool and add the values from the generated capabilities to the Test Evolve configuration.

browser

ruby
2024.1.1
browser: Safari

The browser to open on the LambdaTest device.

device

ruby
2024.1.1
device: iPhone 11 Pro

The name of the LambdaTest device.

os

ruby
2024.1.1
os: ANY

The OS of the LambdaTest device.

os_version

ruby
2024.1.1
os_version: 13

The OS version of the LambdaTest device.

chrome

If you have configured the source to be local, and the browser to be chrome, this section configures options in the chrome browser.

version

nodejs
2023.1.0
ruby
2023.1.0
version: default

Set this value to use your currently installed Chrome browser or to use 'Chrome for Testing' to source other CFT versions.

optiondescription
defaultuse your installed production Chrome browser
117use a specified 'Chrome for Testing' major version
stableuse the latest Stable 'Chrome for Testing' version
betause the latest Beta 'Chrome for Testing' version
devuse the latest Dev 'Chrome for Testing' version
canaryuse the latest Canary 'Chrome for Testing' version

jmeter

nodejs
2021.1.0
ruby
2021.1.0
jmeter: true

proxy traffic through Jmeter to record performance testing scripts.

optiondescription
trueproxies traffic through port 8888
falsedoes not proxy traffic

owasp_zap

nodejs
2021.1.0
ruby
2021.1.0
owasp_zap: true

Proxy traffic through Owasp Zap to analyse for security vulnerabilities.

optiondescription
trueproxies traffic through port 8080
falsedoes not proxy traffic

custom_options

nodejs
2021.1.0
ruby
2021.1.0
custom_options: []

Provide custom options to Chrome.

Example: Executing your tests in a headless browser

custom_options: ['--headless']

accept_insecure_certs

ruby
2021.1.0
accept_insecure_certs: true

Whenever you work with self-signed certificates or some server with a stale or untrusted certificate, most modern browsers display a security warning or invalid certificate errors.

optiondescription
trueAccept insecure certificates
falseDo not accept insecure certificates

chromedriver_version

deprecated since

nodejs
2023.1.0
ruby
2023.1.0
Please remove this option from your configuration file.

download_location

ruby
2021.1.0
nodejs
2024.1.1
download_location: default

Instruct chrome where to store any downloaded artifacts from a test.

optiondescription
defaultuse the standrad downloads folder
path/to/folderchoose a specific directory

edge

If you have configured the source to be local, and the browser to be edge, this section configures options in the edge browser.

version

nodejs
2023.1.3
ruby
2023.1.3
version: default

Set this value to use your currently installed Edge browser, or to download a specified version or a release channel version.

optiondescription
defaultuse your installed production Edge browser
117use a specified Edge major version
stableuse the latest Stable Edge version
betause the latest Beta Edge version
devuse the latest Dev Edge version
canaryuse the latest Canary Edge version (not supported for Windows OS)

jmeter

ruby
2022.1.0
jmeter: true

proxy traffic through Jmeter to record performance testing scripts.

optiondescription
trueproxies traffic through port 8888
falsedoes not proxy traffic

owasp_zap

ruby
2022.1.0
owasp_zap: true

Proxy traffic through Owasp Zap to analyse for security vulnerabilities.

optiondescription
trueproxies traffic through port 8080
falsedoes not proxy traffic

custom_options

ruby
2022.1.0
custom_options: []

Provide custom options to Edge.

Example: Executing your tests in a headless browser

custom_options: ['--headless']

accept_insecure_certs

ruby
2022.1.0
accept_insecure_certs: true

Whenever you work with self-signed certificates or some server with a stale or untrusted certificate, most modern browsers display a security warning or invalid certificate errors.

optiondescription
trueAccept insecure certificates
falseDo not accept insecure certificates

edgedriver_version

deprecated since

nodejs
2023.1.0
ruby
2023.1.0
Please remove this option from your configuration file.

download_location

ruby
2022.1.0
nodejs
2024.1.1
download_location: default

Instruct edge where to store any downloaded artifacts from a test.

optiondescription
defaultuse the standard downloads folder
path/to/folderchoose a specific directory

firefox

version

nodejs
2023.1.2
ruby
2023.1.2
version: default

Set this value to use your currently installed Firefox browser, or to download a specified version or a release channel version.

optiondescription
defaultuse your installed production Firefox browser
117use a specified Firefox major version
stableuse the latest Stable Firefox version
betause the latest Beta Firefox version
devuse the latest Dev Firefox version
nightlyuse the latest Nightly Firefox version

accept_insecure_certs

ruby
2021.1.0
accept_insecure_certs: true

Whenever you work with self-signed certificates or some server with a stale or untrusted certificate, most modern browsers display a security warning or invalid certificate errors.

optiondescription
trueAccept insecure certificates
falseDo not accept insecure certificates

geckodriver_version

deprecated since

nodejs
2023.1.0
ruby
2023.1.0
Please remove this option from your configuration file.

internet_explorer

deprecated since

nodejs
2023.1.0
ruby
2023.1.0
Please remove this option from your configuration file.

Example browser.yml

default_config/browser.yml
&defaults_browser

source: local # local, browserstack, perfecto, sauce_labs, kobiton, local_device

default_timeout: 10
implicit_wait: 0
page_load_timeout: 10

same_browser: true
close_browser: true
clear_cookies: true

local:
platform: desktop # desktop, mobile, tablet

desktop:
browser: chrome # chrome, firefox, ie, safari, edge
maximise: true # true, false
resize: false # true, false
breakpoint:
width: 800
height: 600

mobile:
browser: chrome # chrome, firefox, safari
device: iphone # iphone, ipad, android_phone, android_tablet

browserstack:
platform: desktop # desktop, mobile

local_testing: false
browserstack_debug: true
test_name: Regression Tests
browserstack_options: []

desktop:
browser: Chrome
browser_version: 45
platform: Windows
platform_version: 7
resolution: 1024x768

maximise: true # true, false
resize: false # true, false
breakpoint:
width: 800
height: 600

mobile:
browser_name: Safari
platform: MAC
device: iPhone 6S
os_version: 10.3

perfecto:
platform: desktop # desktop, mobile

connection_timeout: 60

desktop:
platform: Windows
version: 7
browser: Internet Explorer
browser_version: 10
resolution: 1366x768
location: US East

maximise: true # true, false
resize: false # true, false
breakpoint:
width: 800
height: 600

mobile:
device_id: 123456789

sauce_labs:
platform: desktop # desktop, mobile

test_name: Regression Tests

desktop:
platform: Windows 7
browser: Chrome
browser_version: 45
resolution: 1024x768

maximise: true # true, false
resize: false # true, false
breakpoint:
width: 800
height: 600

mobile:
appium: 1.6.0
device: iPhone 7
orientation: portrait
platform_version: 10.0
platform_name: iOS
browser: Safari

kobiton:
session_name: Regression Tests
session_description: Regression Test description
capture_screenshots: false

mobile:
device: iPhone 6S
orientation: portrait
browser: safari
platform_name: iOS
platform_version: 10.2.1

local_device:
command_timeout: 60
appium_options: []

mobile:
device_name: Samsung Galaxy Tab A
browser_name: Chrome
platform_name: Android
platform_version: 5.0.2
udid: 1a4f2d81

lambda_test:
platform: desktop # desktop, mobile
lambda_test_options: [ ]
desktop:
browser: Chrome
browser_version: 120
platform: Windows 10
maximise: true # true, false
resize: false # true, false
breakpoint:
width: 800
height: 600
mobile:
browser: Safari
device: iPhone 12
os: ios
os_version: 14

chrome:

version: default
jmeter: false
owasp_zap: false
custom_options: []
accept_insecure_certs: true
download_location: default

edge:

version: default
jmeter: false
owasp_zap: false
custom_options: []
accept_insecure_certs: true
download_location: default

firefox:

version: default
accept_insecure_certs: true