testcentricity_web 2.1.7 → 2.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e5f8235d007aebe3eebc32d47e11fee9c48a8f6f
-  data.tar.gz: d2c0cbec80747aa8e3acdb711e986b7a079f3cca
+  metadata.gz: ee1d6c11528b5dc1f1aefb1304c415b88a327552
+  data.tar.gz: 4dad0c664b28f41a793bc12b34d6332088b12d59
 SHA512:
-  metadata.gz: 0491b6b3300c0ed2330b09631c68eac18d239c2721f4ce8769443b8007d7fceda99a691c322e272f44365bd5f499827272124486a36a05b9629c48aa5a5783b6
-  data.tar.gz: 94c34fffcf56b0426b8ed35b27de3c58fba272fbbcf53904d4b746d2ea8bacb8e529ea908488509a5839e1a643d0c8fe091b8cc4937372d4fe270357ec202127
+  metadata.gz: a0141ca14252b066550ff7eb00de65327568efe34462230b0e0ef44c62e032f548c86e9e3e0befc541cea55e4b44e563d7a899bd0de5894e42401fc952d4c859
+  data.tar.gz: 3f6c84e76794e9721b8b9175c4672902f65bd28839ccaec0b311f8179ffc3bb68a9adac189e688ce92b35500cfcee0c6c60bd88353e3ba91ee32a319ab634a1b

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_web
 version: !ruby/object:Gem::Version
-  version: 2.1.7
+  version: 2.1.8
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-07 00:00:00.000000000 Z
+date: 2017-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -189,56 +189,7 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files: []
-files:
-- ".gitignore"
-- ".idea/.name"
-- ".idea/encodings.xml"
-- ".idea/misc.xml"
-- ".idea/modules.xml"
-- ".idea/vcs.xml"
-- ".rubocop.yml"
-- ".yardopts"
-- Gemfile
-- LICENSE.txt
-- README.md
-- Rakefile
-- lib/devices/devices.yml
-- lib/testcentricity_web.rb
-- lib/testcentricity_web/browser_helper.rb
-- lib/testcentricity_web/data_objects_helper.rb
-- lib/testcentricity_web/drag_drop_helper.rb
-- lib/testcentricity_web/elements/button.rb
-- lib/testcentricity_web/elements/cell_button.rb
-- lib/testcentricity_web/elements/cell_checkbox.rb
-- lib/testcentricity_web/elements/cell_element.rb
-- lib/testcentricity_web/elements/cell_image.rb
-- lib/testcentricity_web/elements/cell_radio.rb
-- lib/testcentricity_web/elements/checkbox.rb
-- lib/testcentricity_web/elements/file_field.rb
-- lib/testcentricity_web/elements/image.rb
-- lib/testcentricity_web/elements/label.rb
-- lib/testcentricity_web/elements/link.rb
-- lib/testcentricity_web/elements/list.rb
-- lib/testcentricity_web/elements/list_button.rb
-- lib/testcentricity_web/elements/list_checkbox.rb
-- lib/testcentricity_web/elements/list_element.rb
-- lib/testcentricity_web/elements/list_radio.rb
-- lib/testcentricity_web/elements/radio.rb
-- lib/testcentricity_web/elements/select_list.rb
-- lib/testcentricity_web/elements/table.rb
-- lib/testcentricity_web/elements/textfield.rb
-- lib/testcentricity_web/environment.rb
-- lib/testcentricity_web/excel_helper.rb
-- lib/testcentricity_web/exception_queue_helper.rb
-- lib/testcentricity_web/page_objects_helper.rb
-- lib/testcentricity_web/page_sections_helper.rb
-- lib/testcentricity_web/siebel_open_ui_helper.rb
-- lib/testcentricity_web/ui_elements_helper.rb
-- lib/testcentricity_web/utility_helpers.rb
-- lib/testcentricity_web/version.rb
-- lib/testcentricity_web/webdriver_helper.rb
-- lib/testcentricity_web/world_extensions.rb
-- testcentricity_web.gemspec
+files: []
 homepage: ''
 licenses:
 - BSD3

data/.gitignore

@@ -1,27 +0,0 @@
-# OSX folder stuff
-.DS_Store
-Thumbs.db
-
-#IDE project files
-.idea
-.settings
-.project
-.idea/workspace.xml
-.idea/.rakeTasks
-*.iml
-
-doc/*
-.yardoc/*
-notes.txt
-coverage
-.bundle
-.ruby-version
-.ruby-gemset
-/my_templates
-
-Gemfile.lock
-
-
-.idea/testcentricity_web.iml
-
-.idea/.rakeTasks

data/.rubocop.yml

@@ -1,41 +0,0 @@
-# See full list of defaults here: https://github.com/bbatsov/rubocop/blob/master/config/default.yml
-# To see all cops used see here: https://github.com/bbatsov/rubocop/blob/master/config/enabled.yml
-
-Documentation:
-  Enabled: false
-
-AccessorMethodName:
-  Enabled: false
-
-TrivialAccessors:
-  Enabled: false
-
-RedundantReturn:
-  Enabled: false
-
-Metrics/ModuleLength:
-  Enabled: false
-
-Metrics/ClassLength:
-  Enabled: false
-
-Encoding:
-  EnforcedStyle: when_needed
-
-Metrics/LineLength:
-  Enabled: false
-
-Metrics/MethodLength:
-  Enabled: false
-
-Style/RegexpLiteral:
-  Enabled: false
-
-Style/HashSyntax:
-  Enabled: false
-
-Metrics/CyclomaticComplexity:
-  Enabled: false
-
-Style/EmptyLines:
-  Enabled: false

data/.yardopts

@@ -1,2 +0,0 @@
---markup markdown
---markup-provider redcarpet

data/Gemfile

@@ -1,6 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in testcentricity_web.gemspec
-gemspec
-
-gem 'redcarpet', :groups => [:development, :test]

data/LICENSE.txt

@@ -1,28 +0,0 @@
-TestCentricity Web (tm) Framework is Copyright (c) 2014-2017, Tony Mrozinski
-All rights reserved.
-
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice,
-this list of conditions, and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright
-notice, this list of conditions, and the following disclaimer in the
-documentation and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its contributors
-may be used to endorse or promote products derived from this software without
-specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
-INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
-OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
-WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -1,1434 +0,0 @@
-# TestCentricity™ Web
-
-[![Gem Version](https://badge.fury.io/rb/testcentricity_web.svg)](https://badge.fury.io/rb/testcentricity_web)  [![License (3-Clause BSD)](https://img.shields.io/badge/license-BSD%203--Clause-blue.svg?style=flat-square)](http://opensource.org/licenses/BSD-3-Clause)
-
-
-The TestCentricity™ Web core generic framework for desktop and mobile web site testing implements a Page Object and Data Object Model DSL for
-use with Cucumber, Capybara, and Selenium-Webdriver.
-
-The TestCentricity™ Web gem supports running automated tests against the following web test targets:
-
-* locally hosted desktop browsers (Firefox*, Chrome, Safari, or IE)
-* locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within Firefox or Chrome)
-* a "headless" browser (using Poltergeist and PhantomJS)
-* mobile Safari browsers on iOS device simulators (using Appium and XCode on OS X)
-* cloud hosted desktop (Firefox, Chrome, Safari, IE, or Edge) or mobile (iOS Mobile Safari or Android) web browsers using the [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate),
-[Sauce Labs](https://saucelabs.com/open-source#automated-testing-platform), [CrossBrowserTesting](https://crossbrowsertesting.com/selenium-testing), or
-[TestingBot](https://testingbot.com/features) services.
-
-
-**Note:** Test execution against local instances of Firefox version 48 or greater is currently not supported by the TestCentricity™ Web gem. Testing with
-locally hosted instances of Firefox 48 or greater requires Marionette (aka geckodriver) and selenium-webdriver version 3.x, both of which are currently
-feature incomplete and potentially unstable. More information can be found [here](https://github.com/teamcapybara/capybara/issues/1710).
-
-
-## What's New
-###Version 2.1.7
-
-* Updated `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods to use backspace characters to delete contents of a textfield
-instead of using `clear`, which was preventing `onchange` JavaScript events from being triggered in some browsers.
-
-###Version 2.1.5
-
-* Added `get_min`, `get_max`, and `get_step` methods to `TextField` class.
-
-* Updated `PageObject.verify_ui_states` and `PageSection.verify_ui_states` methods to support verification of `min`, `max`, and `step` attributes
-for textfields.
-
-###Version 2.1.4
-
-* Added suppression of the Info Bar that displays "Chrome is being controlled by automated test software" on locally hosted instances of the Chrome browser.
-
-
-###Version 2.1.3
-
-* Added support for "tiling" or cascading multiple browser windows when the `BROWSER_TILE` and `PARALLEL` Environment Variables are set to true. For each
-concurrent parallel thread being executed, the position of each browser will be offset by 100 pixels right and 100 pixels down. For parallel test execution,
-use the [parallel_tests gem](https://github.com/grosser/parallel_tests) to decrease overall test execution time.
-
-###Version 2.1.2
-
-* Added device profiles for Microsoft Lumia 950, Blackberry Leap, Blackberry Passport, and Kindle Fire HD 10
-* Added ability to set browser language support via the `LOCALE` Environment Variable for local instances of Chrome or Firefox browsers
-
-###Version 2.1.0
-
-* Added device profiles for iPhone 8, iPhone 8 Plus, iPhone X devices running iOS 11
-* Added device profile for iPad Pro 10.5" with iOS 11
-* Updated iPhone 7 and iPhone 7 Plus profiles to iOS 10
-* Updated Google Pixel and Google Pixel XL profiles to Android 8
-* Added device profiles for iPhone 7 (iOS 10) with Mobile Chrome browser and iPad (iOS 10) with Mobile Chrome browser
-
-
-## What's Fixed
-###Version 2.1.6
-
-* Fixed bug in `TestCentricity::WebDriverConnect.set_webdriver_path` method that was failing to set the path to the appropriate chromedriver file for OS X
-and Windows.
-
-###Version 2.1.5
-
-* Fixed Chrome and Firefox support for setting browser language via the `LOCALE` Environment Variable. This capability now works for emulated mobile
-browsers hosted in a local instance of Chrome or Firefox.
-
-###Version 2.1.0
-
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method now sets the `Environ` object to the correct device connection states for local and
-cloud hosted browsers.
-* The `TestCentricity::WebDriverConnect.initialize_web_driver` method no longer calls `initialize_browser_size` when running tests against cloud hosted
-mobile web browser, which was resulting in Appium throwing exceptions for unsupported method calls.
-* The `TestCentricity::WebDriverConnect.set_webdriver_path` method now correctly sets the path for Chrome webDrivers when the `HOST_BROWSER` Environment
-Variable is set to `chrome`. Tests against locally hosted emulated mobile web browser running on a local instance of Chrome will now work correctly.
-
-
-## Installation
-
-Add this line to your automation project's Gemfile:
-
-    gem 'testcentricity_web'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install testcentricity_web
-
-
-## Setup
-###Using Cucumber
-
-If you are using Cucumber, you need to require the following in your *env.rb* file:
-
-    require 'capybara'
-    require 'capybara/cucumber'
-    require 'testcentricity_web'
-
-
-###Using RSpec
-
-If you are using RSpec instead, you need to require the following in your *env.rb* file:
-
-    require 'capybara'
-    require 'capybara/rspec'
-    require 'testcentricity_web'
-
-
-### Using Poltergeist
-
-If you will be running your tests on a "headless" web browser using Poltergeist and PhantomJS, you must add this line to your automation
-project's Gemfile:
-
-    gem 'poltergeist'
-
-
-### Using Appium
-
-If you will be running your tests on mobile Safari browsers on simulated iOS devices using Appium and XCode Simulators, you need to require
-the following in your *env.rb* file:
-
-    require 'appium_capybara'
-
-You also need to add this line to your automation project's Gemfile:
-
-    gem 'appium_capybara'
-
-And then execute:
-
-    $ bundle
-
-
-
-## Page Objects
-
-The **Page Object Model** is a test automation pattern that aims to create an abstraction of your web app's User Interface that can be used
-in tests. A **Page Object** is an object that represents a single page in your AUT (Application Under Test). **Page Objects** encapsulate the
-implementation details of a web page and expose an API that supports interaction with, and validation of the UI elements on the page.
-
-**Page Objects** makes it easier to maintain automated tests because changes to page UI elements are updated in only one location - in the
-**Page Object** class definition. By adopting a **Page Object Model**, Cucumber Feature files and step definitions are no longer required to
-hold specific information about a page's UI objects, thus minimizing maintenance requirements. If any element on a page changes (URL path,
-text field attributes, button captions, etc.), maintenance is performed in the **Page Object** class definition only, typically with no need
-to update the affected feature file, scenarios, or step definitions.
-
-
-### Defining a Page Object
-
-Your **Page Object** class definitions should be contained within individual `.rb` files in the `features/support/pages` folder of your
-test automation project. You define new **Page Objects** as shown below:
-
-    class LoginPage < TestCentricity::PageObject
-    end
-
-
-    class HomePage < TestCentricity::PageObject
-    end
-
-
-    class RegistrationPage < TestCentricity::PageObject
-    end
-
-
-### Adding Traits to your Page Object
-
-Web pages typically have names and URLs associated with them. Web pages also typically have a unique object or attribute that, when present,
-indicates that the page's contents have fully loaded.
-
-The `page_name` trait is registered with the **PageManager** object, which includes a `find_page` method that takes a page name as a
-parameter and returns an instance of the associated **Page Object**. If you intend to use the **PageManager**, you must define a `page_name`
-trait for each of the **Page Objects** to be registered.
-
-The `page_name` trait is usually a `String` value that represents the name of the page that will be matched by the `PageManager.findpage` method.
-`page_name` traits are case and white-space sensitive. For pages that may be referenced with multiple names, the `page_name` trait may also be
-an `Array` of `String` values representing those page names.
-
-A `page_url` trait should be defined if a page can be directly loaded using a URL. If you set Capybara's `app_host`, or specify a base URL
-when calling the `WebDriverConnect.initialize_web_driver` method, then your `page_url` trait can be the relative URL slug that will
-be appended to the base URL specified in `app_host`. Specifying a `page_url` trait is optional, as not all web pages can be directly loaded
-via a URL.
-
-A `page_locator` trait is defined if a page has a unique object or attribute that exists once the page's contents have fully loaded. The
-`page_locator` trait is a CSS or Xpath expression that uniquely identifies the object or attribute. The `verify_page_exists` method waits
-for the `page_locator` trait to exist.
-
-You define your page's **Traits** as shown below:
-
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
-    end
-
-
-    class HomePage < TestCentricity::PageObject
-      # this page may be referred to as 'Home' or 'Dashboard' page so page_name trait is an Array of Strings
-      trait(:page_name)       { ['Home', 'Dashboard'] }
-      trait(:page_url)        { '/dashboard' }
-      trait(:page_locator)    { 'body.dashboard' }
-    end
-
-
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
-    end
-
-
-### Adding UI Elements to your Page Object
-
-Web pages are made up of UI elements like text fields, check boxes, combo boxes, radio buttons, tables, lists, buttons, etc.
-**UI Elements** are added to your **Page Object** class definition as shown below:
-
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
-    
-      # Login page UI elements
-      textfield :user_id_field,       'input#userName'
-      textfield :password_field,      'input#password'
-      button    :login_button,        'button#login'
-      checkbox  :remember_checkbox,   'input#rememberUser'
-      label     :error_message_label, 'div#statusBar.login-error'
-    end
-    
-
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
-     
-      # Registration page UI elements
-      textfields  first_name_field:    'input#firstName',
-                  last_name_field:     'input#lastName',
-                  email_field:         'input#email',
-                  phone_number_field:  'input#phone',
-                  address_field:       'input#streetAddress',
-                  city_field:          'input#city',
-                  post_code_field:     'input#postalCode',
-                  password_field:      'input#password',
-                  pword_confirm_field: 'input#passwordConfirmation'
-      selectlists title_select:        'select#title',
-                  gender_select:       'select#gender',
-                  state_select:        'select#stateProvince'
-      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
-      button      :sign_up_button,     'button#registrationSignUp'
-    end
-
-
-### Adding Methods to your Page Object
-
-It is good practice for your Cucumber step definitions to call high level methods in your your **Page Object** instead of directly accessing
-and interacting with a page object's UI elements. You can add high level methods to your **Page Object** class definition for interacting with
-the UI to hide implementation details, as shown below:
-
-    class LoginPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Login' }
-      trait(:page_url)        { '/sign_in' }
-      trait(:page_locator)    { 'body.login-body' }
-    
-      # Login page UI elements
-      textfield :user_id_field,        'input#userName'
-      textfield :password_field,       'input#password'
-      button    :login_button,         'button#login'
-      checkbox  :remember_checkbox,    'input#rememberUser'
-      label     :error_message_label,  'div#statusBar.login-error'
-      link      :forgot_password_link, 'a.forgotPassword'
-    
-      # log in to web app
-      def login(user_id, password)
-        user_id_field.set(user_id)
-        password_field.set(password)
-        login_button.click
-      end
-
-      def remember_me(state)
-        remember_checkbox.set_checkbox_state(state)
-      end
-
-      # verify Login page default UI state
-      def verify_page_ui
-        ui = {
-            login_button         => { :visible => true, :caption => 'LOGIN' },
-            user_id_field        => { :visible => true, :enabled => true },
-            password_field       => { :visible => true, :enabled => true, :value => '', :placeholder => 'Password' },
-            remember_checkbox    => { :exists  => true, :enabled => true, :checked => false },
-            forgot_password_link => { :visible => true, :caption => 'Forgot your password?' },
-            error_message_label  => { :visible => false }
-            }
-        verify_ui_states(ui)
-        super
-      end
-    end
-        
-
-    class RegistrationPage < TestCentricity::PageObject
-      trait(:page_name)       { 'Registration' }
-      trait(:page_url)        { '/register' }
-      trait(:page_locator)    { 'body.registration' }
-     
-      # Registration page UI elements
-      textfields  first_name_field:    'input#firstName',
-                  last_name_field:     'input#lastName',
-                  email_field:         'input#email',
-                  phone_number_field:  'input#phone',
-                  address_field:       'input#streetAddress',
-                  city_field:          'input#city',
-                  post_code_field:     'input#postalCode',
-                  password_field:      'input#password',
-                  pword_confirm_field: 'input#passwordConfirmation'
-      selectlists title_select:        'select#title',
-                  gender_select:       'select#gender',
-                  state_select:        'select#stateProvince'
-      checkbox    :email_opt_in_check, 'input#marketingEmailsOptIn'
-      button      :sign_up_button,     'button#registrationSignUp'
-      
-      # populate Registration page fields with profile data
-      def enter_profile_data(profile)
-        fields = { title_select        => profile.title,
-                   first_name_field    => profile.first_name,
-                   last_name_field     => profile.last_name,
-                   gender_select       => profile.gender,
-                   phone_number_field  => profile.phone,
-                   email_field         => profile.email,
-                   address_field       => profile.address,
-                   city_field          => profile.city,
-                   state_select        => profile.state,
-                   post_code_field     => profile.postal_code,
-                   password_field      => profile.password,
-                   pword_confirm_field => profile.confirm_password
-          }
-        populate_data_fields(fields)
-        sign_up_button.click
-      end
-    end
-
-
-
-Once your **Page Objects** have been instantiated, you can call your methods as shown below:
-
-    login_page.remember_me(true)
-    login_page.user_id_field.set('snicklefritz', 'Pa55w0rd')
-    
-
-
-## PageSection Objects
-
-A **PageSection Object** is a collection of **UI Elements** that may appear in multiple locations on a page, or on multiple pages in a web
-app. It is a collection of **UI Elements** that represent a conceptual area of functionality, like a navigation bar, a search capability,
-or a menu. **UI Elements** and functional behavior are confined to the scope of a **PageSection Object**.
-
-A **PageSection Object** may contain other **PageSection Objects**.
-
-
-### Defining a PageSection Object
-
-Your **PageSection** class definitions should be contained within individual `.rb` files in the `features/support/sections` folder of
-your test automation project. You define new **PageSection Objects** as shown below:
-
-    class SearchForm < TestCentricity::PageSection
-    end
-
-
-### Adding Traits to a PageSection Object
-
-A **PageSection Object** typically has a root node object that encapsulates a collection of **UI Elements**. The `section_locator` trait
-specifies the CSS or Xpath expression that uniquely identifies that root node object.
-
-You define your page section's **Traits** as shown below:
-
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
-    end
-
-
-### Adding UI Elements to your PageSection Object
-
-Page sections are typically made up of UI elements like text fields, check boxes, combo boxes, radio buttons, tables, lists, buttons, etc.
-**UI Elements** are added to your **PageSection** class definition as shown below:
-
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
-        
-      # Search Form UI elements
-      textfield :search_field,  'input#search-query'
-      button    :search_button, 'button[type=submit]'
-    end
-
-
-### Adding Methods to your PageSection Object
-
-You can add high level methods to your **PageSection** class definition, as shown below:
-
-    class SearchForm < TestCentricity::PageSection
-      trait(:section_locator)   { 'form#gnav-search' }
-      trait(:section_name)      { 'Search widget' }
-        
-      # Search Form UI elements
-      textfield :search_field,  'input#search-query'
-      button    :search_button, 'button[type=submit]'
-
-      def search_for(value)
-        search_field.set(value)
-        search_button.click
-      end
-    end
-
-
-### Adding PageSection Objects to your Page Object
-
-You add a **PageSection Object** to its associated **Page Object** as shown below:
-
-    class HomePage < TestCentricity::PageObject
-      trait(:page_name)       { 'Home' }
-      trait(:page_url)        { '/dashboard' }
-      trait(:page_locator)    { 'body.dashboard' }
-      
-      # Home page Section Objects
-      section :search_form, SearchForm
-    end
-
-Once your **Page Object** has been instantiated, you can call its **PageSection** methods as shown below:
-
-    home_page.search_form.search_for('ocarina')
-    
-    
-
-## UI Elements
-
-**Page Objects** and **PageSection Objects** are typically made up of **UI Element** like text fields, check boxes, combo boxes, radio buttons,
-tables, lists, buttons, etc. **UI Elements** are declared and instantiated within the class definition of the **Page Object** or **PageSection
-Object** in which they are contained. With TestCentricity Web, all UI elements are based on the **UIElement** class.
-
-
-### Declaring and Instantiating UI Element
-
-Single **UIElement** declarations have the following format:
-                                     
-    elementType :element Name, locator
-
-* The `element name` is the unique name that you will use to refer to the UI element and is specified as a symbol.
-* The `locator` is the CSS or XPath attribute that uniquely and unambiguously identifies the UI element.
-
-Multiple **UIElement** declarations for a collection of elements of the same type can be performed by passing a hash table containing the
-names and locators of each individual element.
-
-### Example UI Element Declarations
-
-Supported **UI Element** elementTypes and their declarations have the following format:
-
-*Single element declarations:*
-
-    class SamplePage < TestCentricity::PageObject
-
-      button      :button_name, locator
-      textfield   :field_name, locator
-      checkbox    :checkbox_name, locator
-      radio       :radio_button_name, locator
-      label       :label_name, locator
-      link        :link_name, locator
-      selectlist  :select_name, locator
-      list        :list_name, locator
-      table       :table_name, locator
-      image       :image_name, locator
-      filefield   :filefield_name, locator
-      
-    end
- 
-*Multiple element declarations:*
-
-    class SamplePage < TestCentricity::PageObject
-  
-      buttons      button_1_name: locator,
-                   button_2_name: locator,
-                   button_X_name: locator
-      textfields   field_1_name: locator,
-                   field_2_name: locator,
-                   field_X_name: locator
-      checkboxes   check_1_name: locator,
-                   check_2_name: locator,
-                   check_X_name: locator
-      radios       radio_1_name: locator,
-                   radio_X_name: locator
-      labels       label_1_name: locator,
-                   label_X_name: locator
-      links        link_1_name: locator,
-                   link_X_name: locator
-      selectlists  selectlist_1_name: locator,
-                   selectlist_X_name: locator
-      lists        list_1_name: locator,
-                   list_X_name: locator
-      tables       table_1_name: locator,
-                   table_X_name: locator
-      images       image_1_name: locator,
-                   image_X_name: locator
-      filefields   filefield_1_name: locator,
-                   filefield_X_name: locator
-                   
-    end
-
-
-Refer to the Class List documentation for the **PageObject** and **PageSection** classes for details on the class methods used for declaring
-and instantiating **UI Elements**. Examples of UI element declarations can be found in the ***Adding UI Elements to your Page Object*** and
-***Adding UI Elements to your PageSection Object*** sections above.
-
-
-### UIElement Inherited Methods
-
-With TestCentricity, all UI elements are based on the **UIElement** class, and inherit the following methods:
-
-**Action methods:**
-
-    element.click
-    element.double_click
-    element.right_click
-    element.click_at(x, y)
-    element.hover
-    element.drag_by(right_offset, down_offset)
-    element.drag_and_drop(target, right_offset, down_offset)
-
-**Object state methods:**
-
-    element.exists?
-    element.visible?
-    element.hidden?
-    element.enabled?
-    element.disabled?
-    element.get_value
-    element.get_attribute(attrib)
-    element.get_native_attribute(attrib)
-    
-**Waiting methods:**
-
-    element.wait_until_exists(seconds)
-    element.wait_until_gone(seconds)
-    element.wait_until_visible(seconds)
-    element.wait_until_hidden(seconds)
-    element.wait_until_value_is(value, seconds)
-    element.wait_until_value_changes(seconds)
-
-
-## Instantiating your Page Objects
-
-Before you can call the methods in your **Page Objects** and **PageSection Objects**, you must instantiate the **Page Objects** of your
-web application, as well as create instance variables which can be used when calling a **Page Objects** methods from your step definitions.
-There are several ways to instantiate your **Page Objects**.
-
-One common implementation is shown below:
-
-    module WorldPages
-      def login_page
-        @login_page ||= LoginPage.new
-      end
-    
-      def home_page
-        @home_page ||= HomePage.new
-      end
-    
-      def registration_page
-        @registration_page ||= RegistrationPage.new
-      end
-    
-      def search_results_page
-        @search_results_page ||= SearchResultsPage.new
-      end
-    end
-        
-    World(WorldPages)
-
-The `WorldPages` module above can be defined in your `env.rb` file, or you can define it in a separate `world_pages.rb` file in the
-`features/support` folder.
-
-While this approach is effective for small web applications with only a few pages (and hence few **Page Objects**), it quickly becomes
-cumbersome to manage if your web application has dozens of **Page Objects** that need to be instantiated and managed.
-
-### Using the PageManager
-
-The **PageManager** class provides methods for supporting the instantiation and management of **Page Objects**. In the code example below,
-the `page_objects` method contains a hash table of your **Page Object** instances and their associated **Page Object** class names
-to be instantiated by **PageManager**:
-    
-    module WorldPages
-      def page_objects
-        { :login_page                => LoginPage,
-          :home_page                 => HomePage,
-          :registration_page         => RegistrationPage,
-          :search_results_page       => SearchResultsPage,
-          :products_grid_page        => ProductsCollectionPage,
-          :product_detail_page       => ProductDetailPage,
-          :shopping_basket_page      => ShoppingBasketPage,
-          :payment_method_page       => PaymentMethodPage,
-          :confirm_purchase_page     => PurchaseConfirmationPage,
-          :my_account_page           => MyAccountPage,
-          :my_order_history_page     => MyOrderHistoryPage,
-          :my_ship_to_addresses_page => MyShipToAddressesPage,
-          :terms_conditions_page     => TermsConditionsPage,
-          :privacy_policy_page       => PrivacyPolicyPage,
-          :faqs_page                 => FAQsPage,
-          :contact_us_page           => ContactUsPage
-        }
-      end
-    end
-    
-    World(WorldPages)
-    
-The `WorldPages` module above should be defined in the `world_pages.rb` file in the `features/support` folder.
-
-Include the code below in your `env.rb` file to ensure that your **Page Objects** are instantiated before your Cucumber scenarios are
-executed:
-    
-    include WorldPages
-    WorldPages.instantiate_page_objects
-    
-**NOTE:** If you intend to use the **PageManager**, you must define a `page_name` trait for each of the **Page Objects** to be registered.
-
-
-### Leveraging the PageManager in your Cucumber tests
-
-Many Cucumber based automated tests suites include scenarios that verify that web pages are correctly loaded, displayed, or can be
-navigated to by clicking associated links. One such Cucumber navigation scenario is displayed below:
-
-    Scenario Outline:  Verify Home page navigation links
-      Given I am on the Home page
-      When I click the <page> navigation link
-      Then I expect the <page> page to be correctly displayed
-    
-      Examples:
-        |page                    |
-        |Registration            |
-        |My Account              |
-        |Terms & Conditions      |
-        |Privacy Policy          |
-        |FAQs                    |
-        |Contact Us              |
-
-In the above example, the step definitions associated with the 3 steps might be implemented using a page_dispatcher method using a
-`case` statement to parse the `page` parameter as in the example below:
-
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.load_page
-    end
-    
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
-      target_page = page_dispatcher(link_name)
-      target_page.navigate_to
-    end
-    
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists
-      target_page.verify_page_ui
-    end
-    
-    # this method takes a page name as a parameter and returns an instance of the associated Page Object
-    def page_dispatcher(page_name)
-      case page_name
-      when 'Registration'
-        page = registration_page
-      when 'My Account'
-        page = my_account_page
-      when 'Terms & Conditions'
-        page = terms_conditions_page
-      when 'Privacy Policy'
-        page = privacy_policy_page
-      when 'Contact Us'
-        page = contact_us_page
-      when 'FAQs'
-        page = faqs_page
-      end
-      raise "No page object defined for page named '#{page_name}'" unless page
-      page
-    end
-
-
-While this approach may be effective for small web applications with only a few pages (and hence few **Page Objects**), it quickly becomes
-cumbersome to manage if your web application has dozens of **Page Objects** that need to be managed.
-
-The **PageManager** class provides a `find_page` method that replaces the cumbersome and difficult to maintain `case` statement used in the
-above example. The **PageManager** `current_page` method allows you to set or get an instance of the currently active Page Object.
-
-To use these **PageManager** methods, include the step definitions and code below in a `page_steps.rb` or `generic_steps.rb` file in the
-`features/step_definitions` folder:
-
-    include TestCentricity
-    
-    Given(/^I am on the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.load_page if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    When(/^I click the ([^\"]*) navigation link$/) do |link_name|
-      target_page = page_dispatcher(link_name)
-      target_page.navigate_to if target_page
-    end
-    
-    Then(/^I expect to see the ([^\"]*) page$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists if target_page
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    Then(/^I expect the ([^\"]*) page to be correctly displayed$/) do |page_name|
-      target_page = page_dispatcher(page_name)
-      target_page.verify_page_exists
-      target_page.verify_page_ui
-      # let PageManager store an instance of the current page object
-      PageManager.current_page = target_page
-    end
-    
-    # this method takes a page name as a parameter and returns an instance of the associated Page Object
-    def page_dispatcher(page_name)
-      page = PageManager.find_page(page_name)
-      raise "No page object defined for page named '#{page_name}'" unless page
-      page
-    end
-
-
-
-## Connecting to a Web Browser
-
-The `TestCentricity::WebDriverConnect.initialize_web_driver` method configures the appropriate selenium-webdriver capabilities required to establish a
-connection with a target web browser, and sets the base host URL of the web site you are running your tests against.
-
-The `TestCentricity::WebDriverConnect.initialize_web_driver` method accepts a single optional parameter - the base host URL. Cucumber **Environment
-Variables** are used to specify the target local or remote web browser, and the various webdriver capability parameters required to configure
-the connection.
-
-
-### Locally hosted desktop web browser
-
-For locally hosted desktop web browsers running on macOS (OS X) or Windows platforms, the `WEB_BROWSER` Environment Variable must be set to one of the
-values from the table below: 
-
-`WEB_BROWSER` | **Desktop Platform**
---------------|----------------
-`firefox`     | macOS (OS X) or Windows
-`chrome`      | macOS (OS X) or Windows
-`safari`      | macOS (OS X) only
-`ie`          | Windows only
-`poltergeist` | macOS (OS X) or Windows
-
-To set the size of a desktop browser window, you set the `BROWSER_SIZE` Environment Variable to the desired width and height in pixels as shown below:
-                                                                                                                               
-    BROWSER_SIZE=1600,1000
-
-To maximize a desktop browser window, you set the `BROWSER_SIZE` Environment Variable to 'max' as shown below:
-                                                                                                                               
-    BROWSER_SIZE=max
-
-
-### Locally hosted emulated mobile web browser
-
-You can run your tests against mobile device browsers that are emulated within a locally hosted instance of a Firefox or Chrome desktop browser
-on OS X or Windows. The specified mobile browser's user agent, CSS screen dimensions, and default screen orientation will be automatically set
-within the local Firefox or Chrome browser instance. You may even specify the emulated device's screen orientation. For locally hosted emulated
-mobile web browsers, the `WEB_BROWSER` Environment Variable must be set to one of the values from the table below: 
-
-`WEB_BROWSER`         | `HOST_BROWSER`       | **CSS Screen Dimensions** | **Default Orientation**  | **OS Version**
-----------------------|----------------------|-----------|----------|---------
-`ipad`                |`firefox` or `chrome` |1024 x 768 |landscape |iOS 10
-`ipad_pro`            |`firefox` or `chrome` |1366 x 1024|landscape |iOS 11
-`ipad_pro_10_5`       |`firefox` or `chrome` |1112 x 834 |landscape |iOS 11
-`ipad_chrome`         |`firefox` or `chrome` |1024 x 768 |landscape |iOS 10 - Mobile Chrome browser for iOS
-`android_tablet`      |`firefox` or `chrome` |1024 x 768 |landscape |Android 3.0
-`kindle_fire`         |`firefox` or `chrome` |1024 x 600 |landscape |
-`kindle_firehd7`      |`firefox` or `chrome` |800 x 480  |landscape |Fire OS 3
-`kindle_firehd8`      |`firefox` or `chrome` |1280 x 800 |landscape |Fire OS 5
-`kindle_firehd10`     |`firefox` or `chrome` |1920 x 1200 |landscape |Fire OS 5
-`surface`             |`firefox` or `chrome` |1366 x 768 |landscape |
-`blackberry_playbook` |`firefox` or `chrome` |1024 x 600 |landscape |BlackBerry Tablet OS
-`samsung_galaxy_tab`  |`firefox` or `chrome` |1280 x 800 |landscape |Android 4.0.4
-`google_nexus7`       |`firefox` or `chrome` |960 x 600  |landscape |Android 4.4.4
-`google_nexus9`       |`firefox` or `chrome` |1024 x 768 |landscape |Android 5.1
-`google_nexus10`      |`firefox` or `chrome` |1280 x 800 |landscape |Android 5.1
-`iphone`              |`firefox` or `chrome` |320 x 480  |portrait  |iOS 9.1
-`iphone4`             |`firefox` or `chrome` |320 x 480  |portrait  |iOS 9.1
-`iphone5`             |`firefox` or `chrome` |320 x 568  |portrait  |iOS 9.1
-`iphone6`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 9.1
-`iphone6_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 9.1
-`iphone7`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 10
-`iphone7_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 10
-`iphone7_chrome`      |`firefox` or `chrome` |375 x 667  |portrait  |iOS 10 - Mobile Chrome browser for iOS
-`iphone8`             |`firefox` or `chrome` |375 x 667  |portrait  |iOS 11
-`iphone8_plus`        |`firefox` or `chrome` |414 x 736  |portrait  |iOS 11
-`iphonex`             |`firefox` or `chrome` |375 x 812  |portrait  |iOS 11
-`android_phone`       |`firefox` or `chrome` |320 x 480  |portrait  |Android 4
-`nexus6`              |`firefox` or `chrome` |411 x 731  |portrait  |Android 6
-`pixel`               |`firefox` or `chrome` |411 x 731  |portrait  |Android 8
-`pixel_xl`            |`firefox` or `chrome` |411 x 731  |portrait  |Android 8
-`samsung_galaxy_s4`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 5.0.1
-`samsung_galaxy_s5`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 6.0.1
-`samsung_galaxy_s6`   |`firefox` or `chrome` |360 x 640  |portrait  |Android 6.0.1
-`windows_phone7`      |`firefox` or `chrome` |320 x 480  |portrait  |Windows Phone OS 7.5
-`windows_phone8`      |`firefox` or `chrome` |320 x 480  |portrait  |Windows Phone OS 8.0
-`lumia_950_xl`        |`firefox` or `chrome` |360 x 640  |portrait  |Windows Phone OS 10
-`blackberry_z10`      |`firefox` or `chrome` |384 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_z30`      |`firefox` or `chrome` |360 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_leap`     |`firefox` or `chrome` |360 x 640  |portrait  |BlackBerry 10 OS
-`blackberry_passport` |`firefox` or `chrome` |504 x 504  |square    |BlackBerry 10 OS
-
-To change the emulated device's screen orientation from the default setting, set the `ORIENTATION` Environment Variable to either `portrait` or `landscape`.
-
-To use a local instance of the Chrome desktop browser to host the emulated mobile web browser, you must set the `HOST_BROWSER` Environment Variable
-to `chrome`.
-
-
-### Mobile Safari browser on iOS Simulators
-
-You can run your mobile web tests against the mobile Safari browser on simulated iOS devices using Appium and XCode on OS X. You must install XCode, the
-iOS version-specific device simulators for XCode, and Appium. You must ensure that the `appium_capybara` gem is installed and required as described in
-**section 2.4 (Setup - Using Appium)** above.
-
-Appium must be running prior to invoking Cucumber to run your features/scenarios.
-
-Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`       | Must be set to `appium`
-`APP_PLATFORM_NAME` | Must be set to `iOS`
-`APP_BROWSER`       | Must be set to `Safari`
-`APP_VERSION`       | Must be set to `10.0`, `9.3`, `9.2`, or which ever iOS version you wish to run within the XCode Simulator
-`APP_DEVICE`        | Set to iOS device name supported by the iOS Simulator (`iPhone 6s Plus`, `iPad Pro`, `iPad Air 2`, etc.)
-`ORIENTATION`       | [Optional] Set to `portrait` or `landscape`
-`APP_ALLOW_POPUPS`  | [Optional] Allow javascript to open new windows in Safari. Set to `true` or `false`
-`APP_IGNORE_FRAUD_WARNING` | [Optional] Prevent Safari from showing a fraudulent website warning. Set to `true` or `false`
-`APP_NO_RESET`      | [Optional] Don't reset app state after each test. Set to `true` or `false`
-`APP_INITIAL_URL`   | [Optional] Initial URL, default is a local welcome page.  e.g.  `http://www.apple.com`
-`LOCALE`            | [Optional] Locale to set for the simulator.  e.g.  `fr_CA`
-
-
-
-### Remotely hosted desktop and mobile web browsers
-
-You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
-Sauce Labs, or TestingBot services. If your tests are running against a web site hosted on your local computer (`localhost`), or on a
-staging server inside your LAN, you must set the `TUNNELING` Environment Variable to `true`.
-
-
-#### Remote desktop browsers on the BrowserStack service
-
-For remotely hosted desktop web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
-for information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`   | Must be set to `browserstack`
-`BS_USERNAME`   | Must be set to your BrowserStack account user name
-`BS_AUTHKEY`    | Must be set to your BrowserStack account access key
-`BS_OS`         | Must be set to `OS X` or `Windows`
-`BS_OS_VERSION` | Refer to `os_version` capability in chart
-`BS_BROWSER`    | Refer to `browser` capability in chart
-`BS_VERSION`    | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used.
-`TUNNELING`     | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`RESOLUTION`    | [Optional] Refer to supported screen `resolution` capability in chart
-`BROWSER_SIZE`  | [Optional] Specify width, height of browser window
-`RECORD_VIDEO`  | [Optional] Enable screen video recording during test execution (`true` or `false`)
-`TIME_ZONE`     | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
-
-
-#### Remote mobile browsers on the BrowserStack service
-
-For remotely hosted mobile web browsers on the BrowserStack service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities#capabilities-browserstack)
-for information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
----------------  | ----------------
-`WEB_BROWSER`    | Must be set to `browserstack`
-`BS_USERNAME`    | Must be set to your BrowserStack account user name
-`BS_AUTHKEY`     | Must be set to your BrowserStack account access key
-`BS_OS`          | Must be set to `ios` or `android`
-`BS_BROWSER`     | Must be set to `iPhone`, `iPad`, or `android`
-`BS_PLATFORM`    | Must be set to `MAC` (for iOS) or `ANDROID`
-`BS_DEVICE`      | Refer to `device` capability in chart
-`BS_REAL_MOBILE` | Set to `true` if running against a real device
-`TUNNELING`      | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`ORIENTATION`    | [Optional] Set to `portrait` or `landscape`
-`RECORD_VIDEO`   | [Optional] Enable screen video recording during test execution (`true` or `false`)
-`TIME_ZONE`      | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
-
-
-
-#### Remote desktop browsers on the CrossBrowserTesting service
-
-For remotely hosted desktop web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `crossbrowser`
-`CB_USERNAME`  | Must be set to your CrossBrowserTesting account user name or email address
-`CB_AUTHKEY`   | Must be set to your CrossBrowserTesting account access key
-`CB_OS`        | Refer to `os_api_name` capability in the sample script of the Wizard
-`CB_BROWSER`   | Refer to `browser_api_name` capability in the sample script of the Wizard
-`RESOLUTION`   | [Optional] Refer to supported `screen_resolution` capability in the sample script of the Wizard
-`BROWSER_SIZE` | [Optional] Specify width, height of browser window
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-#### Remote mobile browsers on the CrossBrowserTesting service
-
-For remotely hosted mobile web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
-the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `crossbrowser`
-`CB_USERNAME`  | Must be set to your CrossBrowserTesting account user name or email address
-`CB_AUTHKEY`   | Must be set to your CrossBrowserTesting account access key
-`CB_PLATFORM`  | Refer to `os_api_name` capability in the sample script of the Wizard
-`CB_BROWSER`   | Refer to `browser_api_name` capability in the sample script of the Wizard
-`RESOLUTION`   | Refer to supported `screen_resolution` capability in the sample script of the Wizard
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-
-#### Remote desktop browsers on the Sauce Labs service
-
-For remotely hosted desktop web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in
-the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain
-information regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER`  | Must be set to `saucelabs`
-`SL_USERNAME`  | Must be set to your Sauce Labs account user name or email address
-`SL_AUTHKEY`   | Must be set to your Sauce Labs account access key
-`SL_OS`        | Refer to `platform` capability in the Copy Code section of the Platform Configurator page
-`SL_BROWSER`   | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `edge`
-`SL_VERSION`   | Refer to `version` capability in the Copy Code section of the Platform Configurator page
-`RESOLUTION`   | [Optional] Refer to supported `screenResolution` capability in the Copy Code section of the Platform Configurator page
-`BROWSER_SIZE `| [Optional] Specify width, height of browser window
-`RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
-
-
-#### Remote desktop browsers on the TestingBot service
-
-For remotely hosted desktop web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
-regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER` | Must be set to `testingbot`
-`TB_USERNAME` | Must be set to your TestingBot account user name
-`TB_AUTHKEY`  | Must be set to your TestingBot account access key
-`TB_OS`       | Refer to `platform` capability in chart
-`TB_BROWSER`  | Refer to `browserName` capability in chart
-`TB_VERSION`  | Refer to `version` capability in chart
-`TUNNELING`   | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`RESOLUTION`  | [Optional] Possible values: `800x600`, `1024x768`, `1280x960`, `1280x1024`, `1600x1200`, `1920x1200`, `2560x1440`
-`BROWSER_SIZE`| [Optional] Specify width, height of browser window
-
-
-#### Remote mobile browsers on the TestingBot service
-
-For remotely hosted mobile web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
-the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
-regarding the specific capabilities.
-
-**Environment Variable** | **Description**
---------------- | ----------------
-`WEB_BROWSER` | Must be set to `testingbot`
-`TB_USERNAME` | Must be set to your TestingBot account user name
-`TB_AUTHKEY`  | Must be set to your TestingBot account access key
-`TB_OS`       | Must be set to `MAC` (for iOS) or `ANDROID`
-`TB_BROWSER`  | Must be set to `safari` (for iOS) or `browser` (for Android)
-`TB_VERSION`  | Refer to `version` capability in chart
-`TB_PLATFORM` | Must be set to `iOS` or `ANDROID`
-`TB_DEVICE`   | Refer to `deviceName` capability in chart
-`TUNNELING`   | Must be `true` if you are testing against internal/local servers (`true` or `false`)
-`ORIENTATION` | [Optional] Set to `portrait` or `landscape`
-
-
-### Using Browser specific Profiles in cucumber.yml
-
-While you can set **Environment Variables** in the command line when invoking Cucumber, a preferred method of specifying and managing
-target web browsers is to create browser specific **Profiles** that set the appropriate **Environment Variables** for each target browser
-in your `cucumber.yml` file.
-
-Below is a list of Cucumber **Profiles** for supported locally and remotely hosted desktop and mobile web browsers (put these in in your
-`cucumber.yml` file). Before you can use the BrowserStack, CrossBrowserTesting, Sauce Labs, or TestingBot services, you will need to
-replace the *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account and authorization code for the cloud
-service(s) that you intend to connect with.
-
-
-    <% desktop          = "--tags ~@wip --tags ~@failing --tags @desktop --require features BROWSER_SIZE=1600,1000" %>
-    <% mobile           = "--tags ~@wip --tags ~@failing --tags @mobile  --require features" %>
-    
-    #==============
-    # profiles for locally hosted desktop web browsers
-    #==============
-    
-    firefox:            WEB_BROWSER=firefox     <%= desktop %>
-    safari:             WEB_BROWSER=safari      <%= desktop %>
-    chrome:             WEB_BROWSER=chrome      <%= desktop %>
-    ie:                 WEB_BROWSER=ie          <%= desktop %>
-    headless:           WEB_BROWSER=poltergeist <%= desktop %>
-    
-    #==============
-    # profiles for locally hosted mobile web browsers (emulated locally in Firefox browser)
-    # NOTE: to host emulated mobile browsers in Chrome set the HOST_BROWSER=chrome
-    #==============
-    
-    ipad:                WEB_BROWSER=ipad                HOST_BROWSER=firefox <%= mobile %>
-    ipad_pro:            WEB_BROWSER=ipad_pro            HOST_BROWSER=firefox <%= mobile %>
-    ipad_pro_10_5:       WEB_BROWSER=ipad_pro_10_5       HOST_BROWSER=firefox <%= mobile %>
-    ipad_chrome:         WEB_BROWSER=ipad_chrome         HOST_BROWSER=firefox <%= mobile %>
-    iphone:              WEB_BROWSER=iphone              HOST_BROWSER=firefox <%= mobile %>
-    iphone4:             WEB_BROWSER=iphone4             HOST_BROWSER=firefox <%= mobile %>
-    iphone5:             WEB_BROWSER=iphone5             HOST_BROWSER=firefox <%= mobile %>
-    iphone6:             WEB_BROWSER=iphone6             HOST_BROWSER=firefox <%= mobile %>
-    iphone6_plus:        WEB_BROWSER=iphone6_plus        HOST_BROWSER=firefox <%= mobile %>
-    iphone7:             WEB_BROWSER=iphone7             HOST_BROWSER=firefox <%= mobile %>
-    iphone7_plus:        WEB_BROWSER=iphone7_plus        HOST_BROWSER=firefox <%= mobile %>
-    iphone7_chrome:      WEB_BROWSER=iphone7_chrome      HOST_BROWSER=firefox <%= mobile %>
-    iphone8:             WEB_BROWSER=iphone8             HOST_BROWSER=firefox <%= mobile %>
-    iphone8_plus:        WEB_BROWSER=iphone8_plus        HOST_BROWSER=firefox <%= mobile %>
-    iphoneX:             WEB_BROWSER=iphonex             HOST_BROWSER=firefox <%= mobile %>
-    android_phone:       WEB_BROWSER=android_phone       HOST_BROWSER=firefox <%= mobile %>
-    nexus6:              WEB_BROWSER=nexus6              HOST_BROWSER=firefox <%= mobile %>
-    android_tablet:      WEB_BROWSER=android_tablet      HOST_BROWSER=firefox <%= mobile %>
-    kindle_fire:         WEB_BROWSER=kindle_fire         HOST_BROWSER=firefox <%= mobile %>
-    kindle_firehd7:      WEB_BROWSER=kindle_firehd7      HOST_BROWSER=firefox <%= mobile %>
-    kindle_firehd8:      WEB_BROWSER=kindle_firehd8      HOST_BROWSER=firefox <%= mobile %>
-    kindle_firehd10:     WEB_BROWSER=kindle_firehd10     HOST_BROWSER=firefox <%= tablet %>
-    surface:             WEB_BROWSER=surface             HOST_BROWSER=firefox <%= mobile %>
-    blackberry_playbook: WEB_BROWSER=blackberry_playbook HOST_BROWSER=firefox <%= mobile %>
-    samsung_galaxy_tab:  WEB_BROWSER=samsung_galaxy_tab  HOST_BROWSER=firefox <%= mobile %>
-    google_nexus7:       WEB_BROWSER=google_nexus7       HOST_BROWSER=firefox <%= mobile %>
-    google_nexus9:       WEB_BROWSER=google_nexus9       HOST_BROWSER=firefox <%= mobile %>
-    google_nexus10:      WEB_BROWSER=google_nexus10      HOST_BROWSER=firefox <%= mobile %>
-    samsung_galaxy_s4:   WEB_BROWSER=samsung_galaxy_s4   HOST_BROWSER=firefox <%= mobile %>
-    samsung_galaxy_s5:   WEB_BROWSER=samsung_galaxy_s5   HOST_BROWSER=firefox <%= mobile %>
-    samsung_galaxy_s6:   WEB_BROWSER=samsung_galaxy_s6   HOST_BROWSER=firefox <%= mobile %>
-    pixel:               WEB_BROWSER=pixel               HOST_BROWSER=firefox <%= mobile %>
-    pixel_xl:            WEB_BROWSER=pixel_xl            HOST_BROWSER=firefox <%= mobile %>
-    windows_phone7:      WEB_BROWSER=windows_phone7      HOST_BROWSER=firefox <%= mobile %>
-    windows_phone8:      WEB_BROWSER=windows_phone8      HOST_BROWSER=firefox <%= mobile %>
-    lumia_950_xl:        WEB_BROWSER=lumia_950_xl        HOST_BROWSER=firefox <%= mobile %>
-    blackberry_z10:      WEB_BROWSER=blackberry_z10      HOST_BROWSER=firefox <%= mobile %>
-    blackberry_z30:      WEB_BROWSER=blackberry_z30      HOST_BROWSER=firefox <%= mobile %>
-    blackberry_leap:     WEB_BROWSER=blackberry_leap     HOST_BROWSER=firefox <%= mobile %>
-    blackberry_passport: WEB_BROWSER=blackberry_passport HOST_BROWSER=firefox <%= mobile %>
-
-    
-    #==============
-    # profiles for mobile device screen orientation
-    #==============
-    
-    portrait:           ORIENTATION=portrait
-    landscape:          ORIENTATION=landscape
-    
-    
-    #==============
-    # profiles for mobile Safari web browsers hosted within XCode iOS simulator
-    # NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
-    #==============
-    
-    appium_ios:            WEB_BROWSER=appium APP_PLATFORM_NAME="iOS" APP_BROWSER="Safari" <%= mobile %>
-    app_ios_93:            --profile appium_ios APP_VERSION="9.3"
-    app_ios_92:            --profile appium_ios APP_VERSION="9.2"
-    ipad_retina_93_sim:    --profile app_ios_93 APP_DEVICE="iPad Retina"
-    ipad_pro_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Pro"
-    ipad_air_93_sim:       --profile app_ios_93 APP_DEVICE="iPad Air"
-    ipad_air2_93_sim:      --profile app_ios_93 APP_DEVICE="iPad Air 2"
-    ipad_2_93_sim:         --profile app_ios_93 APP_DEVICE="iPad 2"
-    iphone_6s_plus_93_sim: --profile app_ios_93 APP_DEVICE="iPhone 6s Plus"
-    iphone_6s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 6s"
-    iphone_5s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 5s"
-    iphone_4s_93_sim:      --profile app_ios_93 APP_DEVICE="iPhone 4s"
-    
-    
-    #==============
-    # profiles for remotely hosted web browsers on the BrowserStack service
-    #==============
-    
-    browserstack:       WEB_BROWSER=browserstack BS_USERNAME=<INSERT USER NAME HERE> BS_AUTHKEY=<INSERT PASSWORD HERE>
-    bs_desktop:         --profile browserstack <%= desktop %> RESOLUTION="1920x1080"
-    bs_mobile:          --profile browserstack <%= mobile %>
-    
-    # BrowserStack OS X desktop browser profiles
-    bs_macos_sierra:    --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Sierra"
-    bs_ff_sierra:       --profile bs_macos_sierra BS_BROWSER="Firefox"
-    bs_chrome_sierra:   --profile bs_macos_sierra BS_BROWSER="Chrome"
-    bs_safari_sierra:   --profile bs_macos_sierra BS_BROWSER="Safari"
-
-    bs_osx_el_capitan:  --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="El Capitan"
-    bs_ff_el_cap:       --profile bs_osx_el_capitan BS_BROWSER="Firefox"
-    bs_chrome_el_cap:   --profile bs_osx_el_capitan BS_BROWSER="Chrome"
-    bs_safari_el_cap:   --profile bs_osx_el_capitan BS_BROWSER="Safari"
-    
-    bs_osx_yosemite:    --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Yosemite"
-    bs_ff_yos:          --profile bs_osx_yosemite BS_BROWSER="Firefox"
-    bs_chrome_yos:      --profile bs_osx_yosemite BS_BROWSER="Chrome"
-    bs_safari_yos:      --profile bs_osx_yosemite BS_BROWSER="Safari"
-    
-    bs_osx_mavericks:   --profile bs_desktop BS_OS="OS X" BS_OS_VERSION="Mavericks"
-    bs_ff_mav:          --profile bs_osx_mavericks BS_BROWSER="Firefox"
-    bs_chrome_mav:      --profile bs_osx_mavericks BS_BROWSER="Chrome"
-    bs_safari_mav:      --profile bs_osx_mavericks BS_BROWSER="Safari"
-    
-    # BrowserStack Windows desktop browser profiles
-    bs_win7:            --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="7"
-    bs_win8:            --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="8.1"
-    bs_win10:           --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="10"
-    bs_ff_win7:         --profile bs_win7 BS_BROWSER="Firefox"
-    bs_ff_win8:         --profile bs_win8 BS_BROWSER="Firefox"
-    bs_ff_win10:        --profile bs_win10 BS_BROWSER="Firefox"
-    bs_chrome_win7:     --profile bs_win7 BS_BROWSER="Chrome"
-    bs_chrome_win8:     --profile bs_win8 BS_BROWSER="Chrome"
-    bs_chrome_win10:    --profile bs_win10 BS_BROWSER="Chrome"
-    
-    bs_ie_win7:         --profile bs_win7 BS_BROWSER="IE"
-    bs_ie11_win7:       --profile bs_ie_win7 BS_VERSION="11.0"
-    bs_ie10_win7:       --profile bs_ie_win7 BS_VERSION="10.0"
-    bs_ie9_win7:        --profile bs_ie_win7 BS_VERSION="9.0"
-    bs_ie11_win8:       --profile bs_win8 BS_BROWSER="IE" BS_VERSION="11.0"
-    bs_ie10_win8:       --profile bs_desktop BS_OS="Windows" BS_OS_VERSION="8.0" BS_BROWSER="IE" BS_VERSION="10.0"
-    bs_ie11_win10:      --profile bs_win10 BS_BROWSER="IE" BS_VERSION="11.0"
-    bs_edge_win10:      --profile bs_win10 BS_BROWSER="Edge" BS_VERSION="13.0"
-    
-    # BrowserStack iOS mobile browser profiles
-    bs_iphone:          --profile bs_mobile BS_PLATFORM=MAC BS_OS=ios BS_BROWSER=iPhone
-    bs_iphone6s_plus:   --profile bs_iphone BS_DEVICE="iPhone 6S Plus"
-    bs_iphone6s:        --profile bs_iphone BS_DEVICE="iPhone 6S"
-    bs_iphone6_plus:    --profile bs_iphone BS_DEVICE="iPhone 6 Plus"
-    bs_iphone6:         --profile bs_iphone BS_DEVICE="iPhone 6"
-    bs_iphone5s:        --profile bs_iphone BS_DEVICE="iPhone 5S"
-    bs_iphone4s:        --profile bs_iphone BS_DEVICE="iPhone 4S (6.0)"
-    bs_ipad:            --profile bs_mobile BS_PLATFORM=MAC BS_BROWSER=iPad
-    bs_ipad_pro:        --profile bs_ipad BS_DEVICE="iPad Pro"
-    bs_ipad_air2:       --profile bs_ipad BS_DEVICE="iPad Air 2"
-    bs_ipad_air:        --profile bs_ipad BS_DEVICE="iPad Air"
-    bs_ipad_mini:       --profile bs_ipad BS_DEVICE="iPad Mini 4"
-    
-    # BrowserStack iOS real device mobile browser profiles
-    bs_iphone_device:   --profile bs_mobile BS_BROWSER=iPhone BS_OS=ios BS_REAL_MOBILE="true"
-    bs_iphone7_plus:    --profile bs_iphone_device BS_DEVICE="iPhone 7 Plus"
-    bs_iphone7:         --profile bs_iphone_device BS_DEVICE="iPhone 7"
-    
-    # BrowserStack Android mobile browser profiles
-    bs_android:          --profile bs_mobile BS_PLATFORM=ANDROID BS_BROWSER=android BS_OS=android
-    bs_galaxy_s5:        --profile bs_android BS_DEVICE="Samsung Galaxy S5"
-    bs_kindle_fire_hd89: --profile bs_android BS_DEVICE="Amazon Kindle Fire HD 8.9"
-    bs_kindle_fire_hdx7: --profile bs_android BS_DEVICE="Amazon Kindle Fire HDX 7"
-    bs_kindle_fire2:     --profile bs_android BS_DEVICE="Amazon Kindle Fire 2"
-    bs_nexus7:           --profile bs_android BS_DEVICE="Google Nexus 7"
-    bs_nexus5:           --profile bs_android BS_DEVICE="Google Nexus 5"
-    bs_moto_razr:        --profile bs_android BS_DEVICE="Motorola Razr"
-    bs_sony_xperia:      --profile bs_android BS_DEVICE="Sony Xperia Tipo"
-    
-    # BrowserStack Android real device mobile browser profiles
-    bs_android_device:   --profile bs_mobile BS_BROWSER=android BS_OS=android BS_REAL_MOBILE="true"
-    bs_google_pixel8:    --profile bs_android_device BS_DEVICE="Google Pixel" BS_OS_VERSION="8.0"
-    bs_google_pixel71:   --profile bs_android_device BS_DEVICE="Google Pixel" BS_OS_VERSION="7.1"
-    bs_nexus9:           --profile bs_android_device BS_DEVICE="Google Nexus 9"
-    bs_nexus6:           --profile bs_android_device BS_DEVICE="Google Nexus 6"
-    bs_galaxy_s7:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S7"
-    bs_galaxy_s6:        --profile bs_android_device BS_DEVICE="Samsung Galaxy S6"
-    bs_galaxy_note4:     --profile bs_android_device BS_DEVICE="Samsung Galaxy Note 4"
-    
-    
-    #==============
-    # profiles for remotely hosted web browsers on the CrossBrowserTesting service
-    #==============
-    
-    crossbrowser:       WEB_BROWSER=crossbrowser CB_USERNAME=<INSERT USER NAME HERE> CB_AUTHKEY=<INSERT PASSWORD HERE>
-    cb_desktop:         --profile crossbrowser <%= desktop %>
-    cb_mobile:          --profile crossbrowser <%= mobile %>
-    
-    # CrossBrowserTesting OS X desktop browser profiles
-    cb_osx:             --profile cb_desktop RESOLUTION="1920x1200"
-    cb_macos_sierra:    --profile cb_osx CB_OS="Mac10.12"
-    cb_chrome_sierra:   --profile cb_macos_sierra CB_BROWSER="Chrome53x64"
-    cb_safari_sierra:   --profile cb_macos_sierra CB_BROWSER="Safari10"
-    
-    cb_osx_el_capitan:  --profile cb_osx CB_OS="Mac10.11"
-    cb_ff_el_cap:       --profile cb_osx_el_capitan CB_BROWSER="FF46"
-    cb_chrome_el_cap:   --profile cb_osx_el_capitan CB_BROWSER="Chrome48x64"
-    cb_safari_el_cap:   --profile cb_osx_el_capitan CB_BROWSER="Safari9"
-    
-    cb_osx_yosemite:    --profile cb_osx CB_OS="Mac10.10"
-    cb_ff_yos:          --profile cb_osx_yosemite CB_BROWSER="FF46"
-    cb_chrome_yos:      --profile cb_osx_yosemite CB_BROWSER="Chrome48x64"
-    cb_safari_yos:      --profile cb_osx_yosemite CB_BROWSER="Safari8"
-    
-    cb_osx_mavericks:   --profile cb_osx CB_OS="Mac10.9"
-    cb_ff_mav:          --profile cb_osx_mavericks CB_BROWSER="FF46"
-    cb_chrome_mav:      --profile cb_osx_mavericks CB_BROWSER="Chrome48x64"
-    cb_safari_mav:      --profile cb_osx_mavericks CB_BROWSER="Safari7"
-    
-    # CrossBrowserTesting Windows desktop browser profiles
-    cb_win:             --profile cb_desktop RESOLUTION="1920x1080"
-    cb_win7:            --profile cb_win CB_OS="Win7x64-C1"
-    cb_win8:            --profile cb_win CB_OS="Win8"
-    cb_win10:           --profile cb_win CB_OS="Win10"
-    cb_ff_win7:         --profile cb_win7 CB_BROWSER="FF46"
-    cb_ff_win8:         --profile cb_win8 CB_BROWSER="FF46"
-    cb_ff_win10:        --profile cb_win10 CB_BROWSER="FF46"
-    cb_chrome_win7:     --profile cb_win7 CB_BROWSER="Chrome48x64"
-    cb_chrome_win8:     --profile cb_win8 CB_BROWSER="Chrome48x64"
-    cb_chrome_win10:    --profile cb_win10 CB_BROWSER="Chrome48x64"
-    cb_edge_win10:      --profile cb_win10 CB_BROWSER="Edge20"
-    
-    cb_ie11_win7:       --profile cb_win7 CB_BROWSER="IE11"
-    cb_ie10_win7:       --profile cb_win7 CB_BROWSER="IE10"
-    cb_ie9_win7:        --profile cb_win7 CB_BROWSER="IE9"
-    cb_ie11_win8:       --profile cb_win8 CB_BROWSER="IE11"
-    cb_ie10_win8:       --profile cb_win8 CB_BROWSER="IE10"
-    cb_ie11_win10:      --profile cb_win10 CB_BROWSER="IE11"
-    
-    # CrossBrowserTesting iOS mobile browser profiles
-    cb_iphone6s_plus:   --profile cb_mobile CB_PLATFORM="iPhone6sPlus-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="1242x2208"
-    cb_iphone6s:        --profile cb_mobile CB_PLATFORM="iPhone6s-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="750x1334"
-    cb_iphone6_plus:    --profile cb_mobile CB_PLATFORM="iPhone6Plus-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="1242x2208"
-    cb_iphone6:         --profile cb_mobile CB_PLATFORM="iPhone6-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="750x1334"
-    cb_iphone5s:        --profile cb_mobile CB_PLATFORM="iPhone5s-iOS7sim" CB_BROWSER="MblSafari7.0" RESOLUTION="640x1136"
-    cb_ipad_pro:        --profile cb_mobile CB_PLATFORM="iPadPro-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2732x2048"
-    cb_ipad_air2:       --profile cb_mobile CB_PLATFORM="iPadAir2-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2048x1536"
-    cb_ipad_air:        --profile cb_mobile CB_PLATFORM="iPadAir-iOS8Sim" CB_BROWSER="MblSafari8.0" RESOLUTION="2048x1536"
-    cb_ipad_mini:       --profile cb_mobile CB_PLATFORM="iPadMiniRetina-iOS7Sim" CB_BROWSER="MblSafari7.0" RESOLUTION="2048x1536"
-    
-    # CrossBrowserTesting Android mobile browser profiles
-    cb_nexus7:          --profile cb_mobile CB_PLATFORM="Nexus7-And42" CB_BROWSER="MblChrome37" RESOLUTION="800x1280"
-    cb_galaxy_tab2:     --profile cb_mobile CB_PLATFORM="GalaxyTab2-And41" CB_BROWSER="MblChrome38" RESOLUTION="1280x800"
-    cb_galaxy_s5:       --profile cb_mobile CB_PLATFORM="GalaxyS5-And44" CB_BROWSER="MblChrome35" RESOLUTION="1080x1920"
-    cb_galaxy_s4:       --profile cb_mobile CB_PLATFORM="GalaxyS4-And42" CB_BROWSER="MblChrome33" RESOLUTION="1080x1920"
-    
-    
-    #==============
-    # profiles for remotely hosted web browsers on the SauceLabs service
-    #==============
-    
-    saucelabs:          WEB_BROWSER=saucelabs SL_USERNAME=<INSERT USER NAME HERE> SL_AUTHKEY=<INSERT PASSWORD HERE>
-    sl_desktop:         --profile saucelabs <%= desktop %>
-    
-    # SauceLabs OS X desktop browser profiles
-    sl_osx_sierra:      --profile sl_desktop SL_OS="macOS 10.12"
-    sl_ff_sierra:       --profile sl_osx_sierra SL_BROWSER="firefox"
-    sl_chrome_sierra:   --profile sl_osx_sierra SL_BROWSER="chrome"
-    sl_safari_sierra:   --profile sl_osx_sierra SL_BROWSER="safari"
-
-    sl_osx_el_capitan:  --profile sl_desktop SL_OS="OS X 10.11"
-    sl_ff_el_cap:       --profile sl_osx_el_capitan SL_BROWSER="firefox"
-    sl_chrome_el_cap:   --profile sl_osx_el_capitan SL_BROWSER="chrome"
-    sl_safari_el_cap:   --profile sl_osx_el_capitan SL_BROWSER="safari"
-    
-    sl_osx_yosemite:    --profile sl_desktop SL_OS="OS X 10.10" RESOLUTION="1920x1200"
-    sl_ff_yos:          --profile sl_osx_yosemite SL_BROWSER="firefox"
-    sl_chrome_yos:      --profile sl_osx_yosemite SL_BROWSER="chrome"
-    sl_safari_yos:      --profile sl_osx_yosemite SL_BROWSER="safari"
-    
-    sl_osx_mavericks:   --profile sl_desktop SL_OS="OS X 10.9" RESOLUTION="1920x1200"
-    sl_ff_mav:          --profile sl_osx_mavericks SL_BROWSER="firefox"
-    sl_chrome_mav:      --profile sl_osx_mavericks SL_BROWSER="chrome"
-    sl_safari_mav:      --profile sl_osx_mavericks SL_BROWSER="safari"
-    
-    # SauceLabs Windows desktop browser profiles
-    sl_win7:            --profile sl_desktop SL_OS="Windows 7" RESOLUTION="1920x1200"
-    sl_win8:            --profile sl_desktop SL_OS="Windows 8.1" RESOLUTION="1280x1024"
-    sl_win10:           --profile sl_desktop SL_OS="Windows 10" RESOLUTION="1280x1024"
-    sl_ff_win7:         --profile sl_win7 SL_BROWSER="firefox"
-    sl_ff_win8:         --profile sl_win8 SL_BROWSER="firefox"
-    sl_ff_win10:        --profile sl_win10 SL_BROWSER="firefox"
-    sl_chrome_win7:     --profile sl_win7 SL_BROWSER="chrome"
-    sl_chrome_win8:     --profile sl_win8 SL_BROWSER="chrome"
-    sl_chrome_win10:    --profile sl_win10 SL_BROWSER="chrome"
-    
-    sl_ie11_win7:       --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="11.0"
-    sl_ie10_win7:       --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="10.0"
-    sl_ie9_win7:        --profile sl_win7 SL_BROWSER="internet explorer" SL_VERSION="9.0"
-    sl_ie11_win8:       --profile sl_win8 SL_BROWSER="internet explorer" SL_VERSION="11.0"
-    sl_ie11_win10:      --profile sl_win10 SL_BROWSER="internet explorer"
-    
-    
-    #==============
-    # profiles for remotely hosted web browsers on the TestingBot service
-    #==============
-    
-    testingbot:         WEB_BROWSER=testingbot TB_USERNAME=<INSERT USER NAME HERE> TB_AUTHKEY=<INSERT PASSWORD HERE>
-    tb_desktop:         --profile testingbot <%= desktop %> RESOLUTION="1920x1200"
-    tb_mobile:          --profile testingbot <%= mobile %>
-    
-    # TestingBot OS X desktop browser profiles
-    tb_macos_sierra:    --profile tb_desktop TB_OS="SIERRA"
-    tb_ff_sierra:       --profile tb_macos_sierra TB_BROWSER="firefox"
-    tb_chrome_sierra:   --profile tb_macos_sierra TB_BROWSER="chrome"
-    tb_safari_sierra:   --profile tb_macos_sierra TB_BROWSER="safari" TB_VERSION="10"
-    
-    tb_osx_el_capitan:  --profile tb_desktop TB_OS="CAPITAN"
-    tb_ff_el_cap:       --profile tb_osx_el_capitan TB_BROWSER="firefox"
-    tb_chrome_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="chrome"
-    tb_safari_el_cap:   --profile tb_osx_el_capitan TB_BROWSER="safari" TB_VERSION="9"
-    
-    tb_osx_yosemite:    --profile tb_desktop TB_OS="YOSEMITE"
-    tb_ff_yos:          --profile tb_osx_yosemite TB_BROWSER="firefox"
-    tb_chrome_yos:      --profile tb_osx_yosemite TB_BROWSER="chrome"
-    tb_safari_yos:      --profile tb_osx_yosemite TB_BROWSER="safari" TB_VERSION="8"
-    
-    tb_osx_mavericks:   --profile tb_desktop TB_OS="MAVERICKS"
-    tb_ff_mav:          --profile tb_osx_mavericks TB_BROWSER="firefox"
-    tb_chrome_mav:      --profile tb_osx_mavericks TB_BROWSER="chrome"
-    tb_safari_mav:      --profile tb_osx_mavericks TB_BROWSER="safari" TB_VERSION="7"
-    
-    # TestingBot Windows desktop browser profiles
-    tb_win7:            --profile tb_desktop TB_OS="WIN7"
-    tb_win8:            --profile tb_desktop TB_OS="WIN8"
-    tb_win10:           --profile tb_desktop TB_OS="WIN10"
-    tb_ff_win7:         --profile tb_win7 TB_BROWSER="firefox"
-    tb_ff_win8:         --profile tb_win8 TB_BROWSER="firefox"
-    tb_ff_win10:        --profile tb_win10 TB_BROWSER="firefox"
-    tb_chrome_win7:     --profile tb_win7 TB_BROWSER="chrome"
-    tb_chrome_win8:     --profile tb_win8 TB_BROWSER="chrome"
-    tb_chrome_win10:    --profile tb_win10 TB_BROWSER="chrome"
-    
-    tb_ie9_win7:        --profile tb_win7 TB_BROWSER="internet explorer" TB_VERSION="9"
-    tb_ie11_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="11"
-    tb_ie10_win8:       --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="10"
-    tb_ie11_win10:      --profile tb_win10 TB_BROWSER="internet explorer" TB_VERSION="11"
-    tb_edge_win10:      --profile tb_win10 TB_BROWSER="microsoftedge" TB_VERSION="14"
-    
-    # TestingBot iOS mobile browser profiles
-    tb_ios:              --profile tb_mobile TB_OS="MAC" TB_BROWSER="safari" TB_PLATFORM="iOS"
-    tb_iphone6s_plus_10: --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 6s Plus"
-    tb_iphone6s_plus_93: --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6s Plus"
-    tb_iphone6_plus_10:  --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 6 Plus"
-    tb_iphone6_plus_93:  --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6 Plus"
-    tb_iphone6s_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 6s"
-    tb_iphone6s_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 6s"
-    tb_iphone5s_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPhone 5s"
-    tb_iphone5s_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPhone 5s"
-    tb_ipad_pro_10:      --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPad Pro"
-    tb_ipad_pro_93:      --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPad Pro"
-    tb_ipad_air2_10:     --profile tb_ios TB_VERSION="10.0" TB_DEVICE="iPad Air 2"
-    tb_ipad_air2_93:     --profile tb_ios TB_VERSION="9.3"  TB_DEVICE="iPad Air 2"
-    
-    
-    # TestingBot Android mobile browser profiles
-    tb_android:          --profile tb_mobile TB_OS="ANDROID" TB_BROWSER="browser" TB_PLATFORM="Android"
-    tb_nexus_s:          --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus S"
-    tb_nexus_1:          --profile tb_android TB_VERSION="5.0" TB_DEVICE="Nexus 1"
-    tb_nexus_4:          --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus 4"
-    tb_galaxy_nexus:     --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy Nexus"
-    tb_galaxy_s4:        --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy S4"
-    tb_galaxy_s5:        --profile tb_android TB_VERSION="5.0" TB_DEVICE="Galaxy S5"
-    tb_galaxy_s6:        --profile tb_android TB_VERSION="6.0" TB_DEVICE="Galaxy S6"
-
-
-To specify a locally hosted target browser using a profile at runtime, you use the flag `--profile` or `-p` followed by the profile name when
-invoking Cucumber in the command line. For instance, the following command invokes Cucumber and specifies that a local instance of Chrome
-will be used as the target web browser:
-    
-    $ cucumber -p chrome
-
-
-The following command specifies that Cucumber will run tests against a local instance of Firefox, which will be used to emulate an iPad Pro
-in landscape orientation:
-    
-    $ cucumber -p ipad_pro -p landscape
-
-
-The following command specifies that Cucumber will run tests against an iPad Pro with iOS version 9.3 in an XCode Simulator
-in landscape orientation:
-    
-    $ cucumber -p ipad_pro_93_sim -p landscape
-    
-    NOTE:  Appium must be running prior to executing this command
-
-
-The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on an OS X Yosemite
-virtual machine on the BrowserStack service:
-
-    cucumber -p bs_safari_yos
- 
-
-The following command specifies that Cucumber will run tests against a remotely hosted Mobile Safari web browser on an iPhone 6s Plus in
-landscape orientation running on the BrowserStack service:
-
-    $ cucumber -p bs_iphone6_plus -p landscape
-
-
-
-## Web Test Automation Framework Implementation
-
- <img src="http://i.imgur.com/RvpxjzW.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
-
-
-
-
-## Copyright and License
-
-TestCentricity™ Framework is Copyright (c) 2014-2017, Tony Mrozinski.
-All rights reserved.
-
-
-Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions
-are met:
-
-1. Redistributions of source code must retain the above copyright notice, this list of conditions, and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in
-the documentation and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
-ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.