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
RubyNodeJSlambda_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
nodejs
2024.1.2

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
nodejs
2024.1.2
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
nodejs
2024.1.2
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
nodejs
2024.1.2
browser: Chrome

The browser to open in the LambdaTest session.

browser_version​

ruby
2024.1.1
nodejs
2024.1.2
browser_version: 68

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

platform​

ruby
2024.1.1
nodejs
2024.1.2
platform: Windows

The OS of the virtual machine in the LambdaTest session.

maximise​

ruby
2024.1.1
nodejs
2024.1.2
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
nodejs
2024.1.2
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
nodejs
2024.1.2

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
nodejs
2024.1.2
browser: Safari

The browser to open on the LambdaTest device.

device​

ruby
2024.1.1
nodejs
2024.1.2
device: iPhone 11 Pro

The name of the LambdaTest device.

os​

ruby
2024.1.1
nodejs
2024.1.2
os: ANY

The OS of the LambdaTest device.

os_version​

ruby
2024.1.1
nodejs
2024.1.2
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