testcentricity_web 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README.md CHANGED
@@ -4,7 +4,7 @@
4
4
 
5
5
 
6
6
  The TestCentricity™ Web core generic framework for desktop and mobile web browser-based app testing implements a Page Object and Data
7
- Object Model DSL for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.1).
7
+ Object Model DSL for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x).
8
8
 
9
9
  **An example project that demonstrates the implementation of a page object model framework using Cucumber and TestCentricity™ can be found [here](https://github.com/TestCentricity/tc_web_sample).**
10
10
 
@@ -12,15 +12,13 @@ The TestCentricity™ Web gem supports running automated tests against the follo
12
12
  * locally hosted desktop browsers (Firefox, Chrome, Edge, Safari, or IE)
13
13
  * locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
14
14
  * locally hosted "headless" Chrome, Firefox, or Edge browsers
15
- * desktop and emulated mobile web browsers hosted on Selenium Grid and Dockerized Selenium Grid environments
15
+ * remote desktop and emulated mobile web browsers hosted on Selenium Grid 4 and Dockerized Selenium Grid 4 environments
16
16
  * mobile Safari browsers on iOS device simulators or physical iOS devices (using Appium and XCode on OS X)
17
17
  * mobile Chrome or Android browsers on Android Studio virtual device emulators (using Appium and Android Studio on OS X)
18
18
  * cloud hosted desktop (Firefox, Chrome, Safari, IE, or Edge) or mobile (iOS Mobile Safari or Android) web browsers using the following service:
19
19
  * [Browserstack](https://www.browserstack.com/list-of-browsers-and-platforms?product=automate)
20
20
  * [Sauce Labs](https://saucelabs.com/open-source#automated-testing-platform)
21
- * [CrossBrowserTesting](https://crossbrowsertesting.com/selenium-testing)
22
21
  * [TestingBot](https://testingbot.com/features)
23
- * [Gridlastic](https://www.gridlastic.com/test-environments.html)
24
22
  * [LambdaTest](https://www.lambdatest.com/selenium-automation)
25
23
  * web portals utilizing JavaScript front end application frameworks like Ember, React, Angular, and GWT
26
24
  * web pages containing HTML5 Video and Audio objects
@@ -33,7 +31,7 @@ A complete history of bug fixes and new features can be found in the {file:CHANG
33
31
 
34
32
  ## Installation
35
33
 
36
- Add this line to your automation project's Gemfile:
34
+ TestCentricity requires Ruby 2.7 or later. To install the TestCentricity gem, add this line to your automation project's Gemfile:
37
35
 
38
36
  gem 'testcentricity_web'
39
37
 
@@ -80,7 +78,6 @@ And then execute:
80
78
  $ bundle
81
79
 
82
80
 
83
-
84
81
  ## Page Objects
85
82
 
86
83
  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
@@ -740,16 +737,18 @@ the connection.
740
737
  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
741
738
  values from the table below:
742
739
 
743
- `WEB_BROWSER` | **Desktop Platform**
744
- -------------------|----------------
745
- `chrome` | OS X or Windows
746
- `chrome_headless` | OS X or Windows (headless - no visible UI)
747
- `firefox` | OS X or Windows (Firefox version 55 or greater only)
748
- `firefox_headless` | OS X or Windows (headless - no visible UI)
749
- `edge` | OS X or Windows
750
- `edge_headless` | OS X or Windows (headless - no visible UI)
751
- `safari` | OS X only
752
- `ie` | Windows only (IE version 10.x or greater only)
740
+ | `WEB_BROWSER` | **Desktop Platform** |
741
+ |--------------------|------------------------------------------------|
742
+ | `chrome` | OS X or Windows |
743
+ | `chrome_headless` | OS X or Windows (headless - no visible UI) |
744
+ | `firefox` | OS X or Windows |
745
+ | `firefox_headless` | OS X or Windows (headless - no visible UI) |
746
+ | `edge` | OS X or Windows |
747
+ | `edge_headless` | OS X or Windows (headless - no visible UI) |
748
+ | `safari` | OS X only |
749
+ | `ie` | Windows only (IE version 10.x or greater only) |
750
+
751
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
753
752
 
754
753
 
755
754
  #### Setting desktop browser window size
@@ -815,63 +814,65 @@ Windows. The specified mobile browser's user agent, CSS screen dimensions, and d
815
814
  local Chrome browser instance. You may even specify the emulated device's screen orientation. For locally hosted emulated mobile web browsers,
816
815
  the `WEB_BROWSER` Environment Variable must be set to one of the values from the table below:
817
816
 
818
- `WEB_BROWSER` | `HOST_BROWSER` | **CSS Screen Dimensions** | **Default Orientation** | **OS Version**
819
- ----------------------|----------------|---------------------------|-------------------------|---------------
820
- `ipad` |`chrome` |1024 x 768 |landscape |iOS 12
821
- `ipad_pro` |`chrome` |1366 x 1024 |landscape |iOS 12
822
- `ipad_pro_10_5` |`chrome` |1112 x 834 |landscape |iOS 12.2
823
- `ipad_pro_11` |`chrome` |1194 x 834 |landscape |iOS 12.2
824
- `ipad_pro_12_9` |`chrome` |1366 x 1024 |landscape |iOS 13.1
825
- `ipad_chrome` |`chrome` |1024 x 768 |landscape |iOS 12.2 - Mobile Chrome browser for iOS
826
- `ipad_firefox` |`chrome` |1024 x 768 |landscape |iOS 12.2 - Mobile Firefox browser for iOS
827
- `ipad_edge` |`chrome` |1024 x 768 |landscape |iOS 12.2 - Mobile Edge browser for iOS
828
- `android_tablet` |`chrome` |1024 x 768 |landscape |Android 3.0
829
- `kindle_fire` |`chrome` |1024 x 600 |landscape |
830
- `kindle_firehd7` |`chrome` |800 x 480 |landscape |Fire OS 3
831
- `kindle_firehd8` |`chrome` |1280 x 800 |landscape |Fire OS 5
832
- `kindle_firehd10` |`chrome` |1920 x 1200 |landscape |Fire OS 5
833
- `surface` |`chrome` |1366 x 768 |landscape |
834
- `blackberry_playbook` |`chrome` |1024 x 600 |landscape |BlackBerry Tablet OS
835
- `samsung_galaxy_tab` |`chrome` |1280 x 800 |landscape |Android 4.0.4
836
- `google_nexus7` |`chrome` |960 x 600 |landscape |Android 4.4.4
837
- `google_nexus9` |`chrome` |1024 x 768 |landscape |Android 5.1
838
- `google_nexus10` |`chrome` |1280 x 800 |landscape |Android 5.1
839
- `iphone6` |`chrome` |375 x 667 |portrait |iOS 12
840
- `iphone6_plus` |`chrome` |414 x 736 |portrait |iOS 12
841
- `iphone7` |`chrome` |375 x 667 |portrait |iOS 12
842
- `iphone7_plus` |`chrome` |414 x 736 |portrait |iOS 12
843
- `iphone7_chrome` |`chrome` |375 x 667 |portrait |iOS 12.2 - Mobile Chrome browser for iOS
844
- `iphone7_firefox` |`chrome` |375 x 667 |portrait |iOS 12.2 - Mobile Firefox browser for iOS
845
- `iphone7_edge` |`chrome` |375 x 667 |portrait |iOS 12.2 - Microsoft Edge browser for iOS
846
- `iphone8` |`chrome` |375 x 667 |portrait |iOS 12
847
- `iphone8_plus` |`chrome` |414 x 736 |portrait |iOS 12
848
- `iphone_x` |`chrome` |375 x 812 |portrait |iOS 12.2
849
- `iphone_xr` |`chrome` |414 x 896 |portrait |iOS 12.2
850
- `iphone_xs` |`chrome` |375 x 812 |portrait |iOS 12.2
851
- `iphone_xs_max` |`chrome` |414 x 896 |portrait |iOS 12.2
852
- `iphone_11` |`chrome` |414 x 896 |portrait |iOS 13.1
853
- `iphone_11_pro` |`chrome` |375 x 812 |portrait |iOS 13.1
854
- `iphone_11_pro_max` |`chrome` |414 x 896 |portrait |iOS 13.1
855
- `android_phone` |`chrome` |360 x 640 |portrait |Android 4.2.1
856
- `nexus6` |`chrome` |411 x 731 |portrait |Android 6
857
- `pixel` |`chrome` |411 x 731 |portrait |Android 8
858
- `pixel_xl` |`chrome` |411 x 731 |portrait |Android 8
859
- `samsung_galaxy_s4` |`chrome` |360 x 640 |portrait |Android 5.0.1
860
- `samsung_galaxy_s5` |`chrome` |360 x 640 |portrait |Android 6.0.1
861
- `samsung_galaxy_s6` |`chrome` |360 x 640 |portrait |Android 6.0.1
862
- `windows_phone7` |`chrome` |320 x 480 |portrait |Windows Phone OS 7.5
863
- `windows_phone8` |`chrome` |320 x 480 |portrait |Windows Phone OS 8.0
864
- `lumia_950_xl` |`chrome` |360 x 640 |portrait |Windows Phone OS 10
865
- `blackberry_z10` |`chrome` |384 x 640 |portrait |BlackBerry 10 OS
866
- `blackberry_z30` |`chrome` |360 x 640 |portrait |BlackBerry 10 OS
867
- `blackberry_leap` |`chrome` |360 x 640 |portrait |BlackBerry 10 OS
868
- `blackberry_passport` |`chrome` |504 x 504 |square |BlackBerry 10 OS
817
+ | `WEB_BROWSER` | `HOST_BROWSER` | **CSS Screen Dimensions** | **Default Orientation** | **OS Version** |
818
+ |-----------------------|----------------|---------------------------|-------------------------|-------------------------------------------|
819
+ | `ipad` | `chrome` | 1024 x 768 | landscape | iOS 12 |
820
+ | `ipad_pro` | `chrome` | 1366 x 1024 | landscape | iOS 12 |
821
+ | `ipad_pro_10_5` | `chrome` | 1112 x 834 | landscape | iOS 12.2 |
822
+ | `ipad_pro_11` | `chrome` | 1194 x 834 | landscape | iOS 12.2 |
823
+ | `ipad_pro_12_9` | `chrome` | 1366 x 1024 | landscape | iOS 13.1 |
824
+ | `ipad_chrome` | `chrome` | 1024 x 768 | landscape | iOS 12.2 - Mobile Chrome browser for iOS |
825
+ | `ipad_firefox` | `chrome` | 1024 x 768 | landscape | iOS 12.2 - Mobile Firefox browser for iOS |
826
+ | `ipad_edge` | `chrome` | 1024 x 768 | landscape | iOS 12.2 - Mobile Edge browser for iOS |
827
+ | `android_tablet` | `chrome` | 1024 x 768 | landscape | Android 3.0 |
828
+ | `kindle_fire` | `chrome` | 1024 x 600 | landscape | |
829
+ | `kindle_firehd7` | `chrome` | 800 x 480 | landscape | Fire OS 3 |
830
+ | `kindle_firehd8` | `chrome` | 1280 x 800 | landscape | Fire OS 5 |
831
+ | `kindle_firehd10` | `chrome` | 1920 x 1200 | landscape | Fire OS 5 |
832
+ | `surface` | `chrome` | 1366 x 768 | landscape | |
833
+ | `blackberry_playbook` | `chrome` | 1024 x 600 | landscape | BlackBerry Tablet OS |
834
+ | `samsung_galaxy_tab` | `chrome` | 1280 x 800 | landscape | Android 4.0.4 |
835
+ | `google_nexus7` | `chrome` | 960 x 600 | landscape | Android 4.4.4 |
836
+ | `google_nexus9` | `chrome` | 1024 x 768 | landscape | Android 5.1 |
837
+ | `google_nexus10` | `chrome` | 1280 x 800 | landscape | Android 5.1 |
838
+ | `iphone6` | `chrome` | 375 x 667 | portrait | iOS 12 |
839
+ | `iphone6_plus` | `chrome` | 414 x 736 | portrait | iOS 12 |
840
+ | `iphone7` | `chrome` | 375 x 667 | portrait | iOS 12 |
841
+ | `iphone7_plus` | `chrome` | 414 x 736 | portrait | iOS 12 |
842
+ | `iphone7_chrome` | `chrome` | 375 x 667 | portrait | iOS 12.2 - Mobile Chrome browser for iOS |
843
+ | `iphone7_firefox` | `chrome` | 375 x 667 | portrait | iOS 12.2 - Mobile Firefox browser for iOS |
844
+ | `iphone7_edge` | `chrome` | 375 x 667 | portrait | iOS 12.2 - Microsoft Edge browser for iOS |
845
+ | `iphone8` | `chrome` | 375 x 667 | portrait | iOS 12 |
846
+ | `iphone8_plus` | `chrome` | 414 x 736 | portrait | iOS 12 |
847
+ | `iphone_x` | `chrome` | 375 x 812 | portrait | iOS 12.2 |
848
+ | `iphone_xr` | `chrome` | 414 x 896 | portrait | iOS 12.2 |
849
+ | `iphone_xs` | `chrome` | 375 x 812 | portrait | iOS 12.2 |
850
+ | `iphone_xs_max` | `chrome` | 414 x 896 | portrait | iOS 12.2 |
851
+ | `iphone_11` | `chrome` | 414 x 896 | portrait | iOS 13.1 |
852
+ | `iphone_11_pro` | `chrome` | 375 x 812 | portrait | iOS 13.1 |
853
+ | `iphone_11_pro_max` | `chrome` | 414 x 896 | portrait | iOS 13.1 |
854
+ | `android_phone` | `chrome` | 360 x 640 | portrait | Android 4.2.1 |
855
+ | `nexus6` | `chrome` | 411 x 731 | portrait | Android 6 |
856
+ | `pixel` | `chrome` | 411 x 731 | portrait | Android 8 |
857
+ | `pixel_xl` | `chrome` | 411 x 731 | portrait | Android 8 |
858
+ | `samsung_galaxy_s4` | `chrome` | 360 x 640 | portrait | Android 5.0.1 |
859
+ | `samsung_galaxy_s5` | `chrome` | 360 x 640 | portrait | Android 6.0.1 |
860
+ | `samsung_galaxy_s6` | `chrome` | 360 x 640 | portrait | Android 6.0.1 |
861
+ | `windows_phone7` | `chrome` | 320 x 480 | portrait | Windows Phone OS 7.5 |
862
+ | `windows_phone8` | `chrome` | 320 x 480 | portrait | Windows Phone OS 8.0 |
863
+ | `lumia_950_xl` | `chrome` | 360 x 640 | portrait | Windows Phone OS 10 |
864
+ | `blackberry_z10` | `chrome` | 384 x 640 | portrait | BlackBerry 10 OS |
865
+ | `blackberry_z30` | `chrome` | 360 x 640 | portrait | BlackBerry 10 OS |
866
+ | `blackberry_leap` | `chrome` | 360 x 640 | portrait | BlackBerry 10 OS |
867
+ | `blackberry_passport` | `chrome` | 504 x 504 | square | BlackBerry 10 OS |
869
868
 
870
869
  To change the emulated device's screen orientation from the default setting, set the `ORIENTATION` Environment Variable to either `portrait` or `landscape`.
871
870
 
872
871
  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
873
872
  to `chrome`.
874
873
 
874
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
875
+
875
876
 
876
877
  #### User defined mobile device profiles
877
878
 
@@ -905,16 +906,17 @@ The format for a new device profile is:
905
906
  :user_agent: "user agent string"
906
907
  ```
907
908
 
908
- ### Selenium Grid and Dockerized Selenium Grid hosted desktop and emulated mobile web browsers
909
+ ### Selenium Grid 4 and Dockerized Selenium Grid 4 hosted desktop and emulated mobile web browsers
909
910
 
910
- For desktop and emulated mobile web browsers running on Selenium Grid or Dockerized Selenium Grid environments ([like Zalenium](https://opensource.zalando.com/zalenium/)), the following **Environment Variables** must be set
911
- as described in the table below.
911
+ For remote desktop and emulated mobile web browsers running on Selenium Grid 4 or Dockerized Selenium Grid 4 environments as described in the table below.
912
912
 
913
- **Environment Variable** | **Description**
914
- --------------- | ----------------
915
- `WEB_BROWSER` | Must be set to one of the following desktop browsers - `chrome`, `chrome_headless`, or `firefox`, or any of the mobile web browsers described above.
916
- `SELENIUM` | Must be set to `remote`
917
- `REMOTE_ENDPOINT` | Must be set to the URL of the Grid hub, which is usually `http://localhost:4444/wd/hub`
913
+ | **Environment Variable** | **Description** |
914
+ |--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
915
+ | `WEB_BROWSER` | Must be set to one of the following desktop browsers - `chrome`, `chrome_headless`, `edge`, `edge_headless`, or `firefox`, or any of the mobile web browsers described above. |
916
+ | `SELENIUM` | Must be set to `remote` |
917
+ | `REMOTE_ENDPOINT` | Must be set to the URL of the Grid hub, which is usually `http://localhost:4444/wd/hub` |
918
+
919
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
918
920
 
919
921
 
920
922
  ### Mobile Safari browser on iOS Simulators or iOS Physical Devices
@@ -928,29 +930,31 @@ The Appium server must be running prior to invoking Cucumber to run your feature
928
930
 
929
931
  Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
930
932
 
931
- **Environment Variable** | **Description**
932
- --------------- | ----------------
933
- `WEB_BROWSER` | Must be set to `appium`
934
- `APP_PLATFORM_NAME` | Must be set to `iOS`
935
- `APP_BROWSER` | Must be set to `Safari`
936
- `APP_VERSION` | Must be set to `12.2`, `11.4`, `10.3.1`, or which ever iOS version you wish to run within the XCode Simulator
937
- `APP_DEVICE` | Set to iOS device name supported by the iOS Simulator (`iPhone 6s Plus`, `iPad Pro (10.5-inch)`, `iPad Air 2`, etc.) or name of physically connected iOS device
938
- `DEVICE_TYPE` | Must be set to `phone` or `tablet`
939
- `APP_UDID` | UDID of physically connected iOS device (not used for simulators)
940
- `TEAM_ID` | unique 10-character Apple developer team identifier string (not used for simulators)
941
- `TEAM_NAME` | String representing a signing certificate (not used for simulators)
942
- `APP_ALLOW_POPUPS` | [Optional] Allow javascript to open new windows in Safari. Set to `true` or `false`
943
- `APP_IGNORE_FRAUD_WARNING` | [Optional] Prevent Safari from showing a fraudulent website warning. Set to `true` or `false`
944
- `APP_NO_RESET` | [Optional] Don't reset app state after each test. Set to `true` or `false`
945
- `APP_FULL_RESET` | [Optional] Perform a complete reset. Set to `true` or `false`
946
- `APP_INITIAL_URL` | [Optional] Initial URL, default is a local welcome page. e.g. `http://www.apple.com`
947
- `WDA_LOCAL_PORT` | [Optional] Used to forward traffic from Mac host to real iOS devices over USB. Default value is same as port number used by WDA on device.
948
- `LOCALE` | [Optional] Locale to set for the simulator. e.g. `fr_CA`
949
- `LANGUAGE` | [Optional] Language to set for the simulator. e.g. `fr`
950
- `ORIENTATION` | [Optional] Set to `portrait` or `landscape` (only for iOS simulators)
951
- `NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client
952
- `SHOW_SIM_KEYBOARD` | [Optional] Show the simulator keyboard during text entry. Set to `true` or `false`
953
- `SHUTDOWN_OTHER_SIMS`| [Optional] Close any other running simulators. Set to `true` or `false`
933
+ | **Environment Variable** | **Description** |
934
+ |----------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
935
+ | `WEB_BROWSER` | Must be set to `appium` |
936
+ | `APP_PLATFORM_NAME` | Must be set to `iOS` |
937
+ | `APP_BROWSER` | Must be set to `Safari` |
938
+ | `APP_VERSION` | Must be set to `12.2`, `11.4`, `10.3.1`, or which ever iOS version you wish to run within the XCode Simulator |
939
+ | `APP_DEVICE` | Set to iOS device name supported by the iOS Simulator (`iPhone 6s Plus`, `iPad Pro (10.5-inch)`, `iPad Air 2`, etc.) or name of physically connected iOS device |
940
+ | `DEVICE_TYPE` | Must be set to `phone` or `tablet` |
941
+ | `APP_UDID` | UDID of physically connected iOS device (not used for simulators) |
942
+ | `TEAM_ID` | unique 10-character Apple developer team identifier string (not used for simulators) |
943
+ | `TEAM_NAME` | String representing a signing certificate (not used for simulators) |
944
+ | `APP_ALLOW_POPUPS` | [Optional] Allow javascript to open new windows in Safari. Set to `true` or `false` |
945
+ | `APP_IGNORE_FRAUD_WARNING` | [Optional] Prevent Safari from showing a fraudulent website warning. Set to `true` or `false` |
946
+ | `APP_NO_RESET` | [Optional] Don't reset app state after each test. Set to `true` or `false` |
947
+ | `APP_FULL_RESET` | [Optional] Perform a complete reset. Set to `true` or `false` |
948
+ | `APP_INITIAL_URL` | [Optional] Initial URL, default is a local welcome page. e.g. `http://www.apple.com` |
949
+ | `WDA_LOCAL_PORT` | [Optional] Used to forward traffic from Mac host to real iOS devices over USB. Default value is same as port number used by WDA on device. |
950
+ | `LOCALE` | [Optional] Locale to set for the simulator. e.g. `fr_CA` |
951
+ | `LANGUAGE` | [Optional] Language to set for the simulator. e.g. `fr` |
952
+ | `ORIENTATION` | [Optional] Set to `portrait` or `landscape` (only for iOS simulators) |
953
+ | `NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client |
954
+ | `SHOW_SIM_KEYBOARD` | [Optional] Show the simulator keyboard during text entry. Set to `true` or `false` |
955
+ | `SHUTDOWN_OTHER_SIMS` | [Optional] Close any other running simulators. Set to `true` or `false` |
956
+
957
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
954
958
 
955
959
 
956
960
  ### Mobile Chrome or Android browsers on Android Studio Virtual Device emulators
@@ -965,29 +969,33 @@ for information on configuring Appium to use the correct version of Chromedriver
965
969
 
966
970
  Once your test environment is properly configured, the following **Environment Variables** must be set as described in the table below.
967
971
 
968
- **Environment Variable** | **Description**
969
- --------------- | ----------------
970
- `WEB_BROWSER` | Must be set to `appium`
971
- `APP_PLATFORM_NAME` | Must be set to `Android`
972
- `APP_BROWSER` | Must be set to `Chrome` or `Browser`
973
- `APP_VERSION` | Must be set to `8.0`, `7.0`, or which ever Android OS version you wish to run with the Android Virtual Device
974
- `APP_DEVICE` | Set to Android Virtual Device ID (`Pixel_2_XL_API_26`, `Nexus_6_API_23`, etc.) found in Advanced Settings of AVD Configuration
975
- `DEVICE_TYPE` | Must be set to `phone` or `tablet`
976
- `ORIENTATION` | [Optional] Set to `portrait` or `landscape`
977
- `APP_INITIAL_URL` | [Optional] Initial URL, default is a local welcome page. e.g. `http://www.apple.com`
978
- `APP_NO_RESET` | [Optional] Don't reset app state after each test. Set to `true` or `false`
979
- `APP_FULL_RESET` | [Optional] Perform a complete reset. Set to `true` or `false`
980
- `LOCALE` | [Optional] Locale to set for the simulator. e.g. `fr_CA`
981
- `LANGUAGE` | [Optional] Language to set for the simulator. e.g. `fr`
982
- `NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client
983
- `CHROMEDRIVER_EXECUTABLE` | [Optional] Absolute local path to webdriver executable
972
+ | **Environment Variable** | **Description** |
973
+ |---------------------------|--------------------------------------------------------------------------------------------------------------------------------|
974
+ | `WEB_BROWSER` | Must be set to `appium` |
975
+ | `APP_PLATFORM_NAME` | Must be set to `Android` |
976
+ | `APP_BROWSER` | Must be set to `Chrome` or `Browser` |
977
+ | `APP_VERSION` | Must be set to `8.0`, `7.0`, or which ever Android OS version you wish to run with the Android Virtual Device |
978
+ | `APP_DEVICE` | Set to Android Virtual Device ID (`Pixel_2_XL_API_26`, `Nexus_6_API_23`, etc.) found in Advanced Settings of AVD Configuration |
979
+ | `DEVICE_TYPE` | Must be set to `phone` or `tablet` |
980
+ | `ORIENTATION` | [Optional] Set to `portrait` or `landscape` |
981
+ | `APP_INITIAL_URL` | [Optional] Initial URL, default is a local welcome page. e.g. `http://www.apple.com` |
982
+ | `APP_NO_RESET` | [Optional] Don't reset app state after each test. Set to `true` or `false` |
983
+ | `APP_FULL_RESET` | [Optional] Perform a complete reset. Set to `true` or `false` |
984
+ | `LOCALE` | [Optional] Locale to set for the simulator. e.g. `fr_CA` |
985
+ | `LANGUAGE` | [Optional] Language to set for the simulator. e.g. `fr` |
986
+ | `NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client |
987
+ | `CHROMEDRIVER_EXECUTABLE` | [Optional] Absolute local path to webdriver executable |
988
+
989
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
984
990
 
985
991
 
986
992
  ### Remotely hosted desktop and mobile web browsers
987
993
 
988
- You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, CrossBrowserTesting,
989
- Sauce Labs, TestingBot, Gridlastic, or LambdaTest services. If your tests are running against a web site hosted on your local computer
990
- (`localhost`), or on a staging server inside your LAN, you must set the `TUNNELING` Environment Variable to `true`.
994
+ You can run your automated tests against remotely hosted desktop and mobile web browsers using the BrowserStack, SauceLabs, TestingBot, or
995
+ LambdaTest services. If your tests are running against a web site hosted on your local computer (`localhost`), or on a staging server inside
996
+ your LAN, you must set the `TUNNELING` Environment Variable to `true`.
997
+
998
+ Refer to **section 8.7 (Using Browser specific Profiles in cucumber.yml)** below.
991
999
 
992
1000
 
993
1001
  #### Remote desktop browsers on the BrowserStack service
@@ -996,24 +1004,24 @@ For remotely hosted desktop web browsers on the BrowserStack service, the follow
996
1004
  the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
997
1005
  for information regarding the specific capabilities.
998
1006
 
999
- **Environment Variable** | **Description**
1000
- ------------------ | ----------------
1001
- `WEB_BROWSER` | Must be set to `browserstack`
1002
- `BS_USERNAME` | Must be set to your BrowserStack account user name
1003
- `BS_AUTHKEY` | Must be set to your BrowserStack account access key
1004
- `BS_OS` | Must be set to `OS X` or `Windows`
1005
- `BS_OS_VERSION` | Refer to `os_version` capability in chart
1006
- `BS_BROWSER` | Refer to `browser` capability in chart
1007
- `BS_VERSION` | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used.
1008
- `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
1009
- `RESOLUTION` | [Optional] Refer to supported screen `resolution` capability in chart
1010
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1011
- `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
1012
- `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code.
1013
- `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only
1014
- `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only
1015
- `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`)
1016
- `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`)
1007
+ | **Environment Variable** | **Description** |
1008
+ |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
1009
+ | `WEB_BROWSER` | Must be set to `browserstack` |
1010
+ | `BS_USERNAME` | Must be set to your BrowserStack account user name |
1011
+ | `BS_AUTHKEY` | Must be set to your BrowserStack account access key |
1012
+ | `BS_OS` | Must be set to `OS X` or `Windows` |
1013
+ | `BS_OS_VERSION` | Refer to `os_version` capability in chart |
1014
+ | `BS_BROWSER` | Refer to `browser` capability in chart |
1015
+ | `BS_VERSION` | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used. |
1016
+ | `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started. |
1017
+ | `RESOLUTION` | [Optional] Refer to supported screen `resolution` capability in chart |
1018
+ | `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
1019
+ | `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart |
1020
+ | `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code. |
1021
+ | `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only |
1022
+ | `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only |
1023
+ | `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`) |
1024
+ | `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`) |
1017
1025
 
1018
1026
  If the BrowserStack Local instance is running (`TUNNELING` Environment Variable is `true`), call the`TestCentricity::WebDriverConnect.close_tunnel` method
1019
1027
  upon completion of your test suite to stop the Local instance. Place the code shown below in your `env.rb` or `hooks.rb` file.
@@ -1030,63 +1038,24 @@ For remotely hosted mobile web browsers on the BrowserStack service, the followi
1030
1038
  the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
1031
1039
  for information regarding the specific capabilities.
1032
1040
 
1033
- **Environment Variable** | **Description**
1034
- --------------- | ----------------
1035
- `WEB_BROWSER` | Must be set to `browserstack`
1036
- `BS_USERNAME` | Must be set to your BrowserStack account user name
1037
- `BS_AUTHKEY` | Must be set to your BrowserStack account access key
1038
- `BS_OS` | Must be set to `ios` or `android`
1039
- `BS_BROWSER` | Must be set to `Safari` (for iOS) or `Chrome` (for Android)
1040
- `BS_DEVICE` | Refer to `device` capability in chart
1041
- `BS_REAL_MOBILE` | Set to `true` if running against a real device
1042
- `DEVICE_TYPE` | Must be set to `phone` or `tablet`
1043
- `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started.
1044
- `ORIENTATION` | [Optional] Set to `portrait` or `landscape`
1045
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1046
- `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
1047
- `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code.
1048
- `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`)
1049
- `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`)
1050
- `APPIUM_LOGS` | [Optional] Generate Appium logs (`true` or `false`)
1051
-
1052
-
1053
-
1054
- #### Remote desktop browsers on the CrossBrowserTesting service
1055
-
1056
- For remotely hosted desktop web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
1057
- the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
1058
- information regarding the specific capabilities.
1059
-
1060
- **Environment Variable** | **Description**
1061
- --------------- | ----------------
1062
- `WEB_BROWSER` | Must be set to `crossbrowser`
1063
- `CB_USERNAME` | Must be set to your CrossBrowserTesting account user name or email address
1064
- `CB_AUTHKEY` | Must be set to your CrossBrowserTesting account access key
1065
- `CB_OS` | Refer to `os_api_name` capability in the sample script of the Wizard
1066
- `CB_BROWSER` | Refer to `browser_api_name` capability in the sample script of the Wizard
1067
- `RESOLUTION` | [Optional] Refer to supported `screen_resolution` capability in the sample script of the Wizard
1068
- `BROWSER_SIZE` | [Optional] Specify width, height of browser window
1069
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1070
-
1071
-
1072
- #### Remote mobile browsers on the CrossBrowserTesting service
1073
-
1074
- For remotely hosted mobile web browsers on the CrossBrowserTesting service, the following **Environment Variables** must be set as described in
1075
- the table below. Use the Configuration Wizard on the [Start a Selenium Test page](https://app.crossbrowsertesting.com/selenium/run) to obtain
1076
- information regarding the specific capabilities.
1077
-
1078
- **Environment Variable** | **Description**
1079
- --------------- | ----------------
1080
- `WEB_BROWSER` | Must be set to `crossbrowser`
1081
- `CB_USERNAME` | Must be set to your CrossBrowserTesting account user name or email address
1082
- `CB_AUTHKEY` | Must be set to your CrossBrowserTesting account access key
1083
- `CB_PLATFORM` | Refer to `os_api_name` capability in the sample script of the Wizard
1084
- `CB_BROWSER` | Refer to `browser_api_name` capability in the sample script of the Wizard
1085
- `RESOLUTION` | Refer to supported `screen_resolution` capability in the sample script of the Wizard
1086
- `DEVICE_TYPE` | Must be set to `phone` or `tablet`
1087
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1088
-
1089
-
1041
+ | **Environment Variable** | **Description** |
1042
+ |--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
1043
+ | `WEB_BROWSER` | Must be set to `browserstack` |
1044
+ | `BS_USERNAME` | Must be set to your BrowserStack account user name |
1045
+ | `BS_AUTHKEY` | Must be set to your BrowserStack account access key |
1046
+ | `BS_OS` | Must be set to `ios` or `android` |
1047
+ | `BS_BROWSER` | Must be set to `Safari` (for iOS) or `Chrome` (for Android) |
1048
+ | `BS_DEVICE` | Refer to `device` capability in chart |
1049
+ | `BS_REAL_MOBILE` | Set to `true` if running against a real device |
1050
+ | `DEVICE_TYPE` | Must be set to `phone` or `tablet` |
1051
+ | `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started. |
1052
+ | `ORIENTATION` | [Optional] Set to `portrait` or `landscape` |
1053
+ | `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
1054
+ | `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart |
1055
+ | `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code. |
1056
+ | `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`) |
1057
+ | `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`) |
1058
+ | `APPIUM_LOGS` | [Optional] Generate Appium logs (`true` or `false`) |
1090
1059
 
1091
1060
  #### Remote desktop browsers on the Sauce Labs service
1092
1061
 
@@ -1094,18 +1063,18 @@ For remotely hosted desktop web browsers on the Sauce Labs service, the followin
1094
1063
  the table below. Use the Selenium API on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/) to obtain
1095
1064
  information regarding the specific capabilities.
1096
1065
 
1097
- **Environment Variable** | **Description**
1098
- --------------- | ----------------
1099
- `WEB_BROWSER` | Must be set to `saucelabs`
1100
- `SL_USERNAME` | Must be set to your Sauce Labs account user name or email address
1101
- `SL_AUTHKEY` | Must be set to your Sauce Labs account access key
1102
- `SL_OS` | Refer to `platform` capability in the Copy Code section of the Platform Configurator page
1103
- `SL_BROWSER` | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `edge`
1104
- `SL_VERSION` | Refer to `version` capability in the Copy Code section of the Platform Configurator page
1105
- `RESOLUTION` | [Optional] Refer to supported `screenResolution` capability in the Copy Code section of the Platform Configurator page
1106
- `BROWSER_SIZE `| [Optional] Specify width, height of browser window
1107
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1108
-
1066
+ | **Environment Variable** | **Description** |
1067
+ |--------------------------|------------------------------------------------------------------------------------------------------------------------|
1068
+ | `WEB_BROWSER` | Must be set to `saucelabs` |
1069
+ | `SL_USERNAME` | Must be set to your Sauce Labs account user name or email address |
1070
+ | `SL_AUTHKEY` | Must be set to your Sauce Labs account access key |
1071
+ | `DATA_CENTER` | Must be set to your Sauce Labs account Data Center assignment (`us-west-1`, `eu-central-1`, `apac-southeast-1`) |
1072
+ | `SL_OS` | Refer to `platform` capability in the Copy Code section of the Platform Configurator page |
1073
+ | `SL_BROWSER` | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `edge` |
1074
+ | `SL_VERSION` | Refer to `version` capability in the Copy Code section of the Platform Configurator page |
1075
+ | `RESOLUTION` | [Optional] Refer to supported `screenResolution` capability in the Copy Code section of the Platform Configurator page |
1076
+ | `BROWSER_SIZE ` | [Optional] Specify width, height of browser window |
1077
+ | `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
1109
1078
 
1110
1079
  #### Remote desktop browsers on the TestingBot service
1111
1080
 
@@ -1113,60 +1082,17 @@ For remotely hosted desktop web browsers on the TestingBot service, the followin
1113
1082
  the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
1114
1083
  regarding the specific capabilities.
1115
1084
 
1116
- **Environment Variable** | **Description**
1117
- --------------- | ----------------
1118
- `WEB_BROWSER` | Must be set to `testingbot`
1119
- `TB_USERNAME` | Must be set to your TestingBot account user name
1120
- `TB_AUTHKEY` | Must be set to your TestingBot account access key
1121
- `TB_OS` | Refer to `platform` capability in chart
1122
- `TB_BROWSER` | Refer to `browserName` capability in chart
1123
- `TB_VERSION` | Refer to `version` capability in chart
1124
- `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`)
1125
- `RESOLUTION` | [Optional] Possible values: `800x600`, `1024x768`, `1280x960`, `1280x1024`, `1600x1200`, `1920x1200`, `2560x1440`
1126
- `BROWSER_SIZE`| [Optional] Specify width, height of browser window
1127
-
1128
-
1129
- #### Remote mobile browsers on the TestingBot service
1130
-
1131
- For remotely hosted mobile web browsers on the TestingBot service, the following **Environment Variables** must be set as described in
1132
- the table below. Refer to the [TestingBot List of Available Browsers page](https://testingbot.com/support/getting-started/browsers.html) for information
1133
- regarding the specific capabilities.
1134
-
1135
- **Environment Variable** | **Description**
1136
- --------------- | ----------------
1137
- `WEB_BROWSER` | Must be set to `testingbot`
1138
- `TB_USERNAME` | Must be set to your TestingBot account user name
1139
- `TB_AUTHKEY` | Must be set to your TestingBot account access key
1140
- `TB_OS` | Must be set to `MAC` (for iOS) or `ANDROID`
1141
- `TB_BROWSER` | Must be set to `safari` (for iOS) or `browser` (for Android)
1142
- `TB_VERSION` | Refer to `version` capability in chart
1143
- `TB_PLATFORM` | Must be set to `iOS` or `ANDROID`
1144
- `TB_DEVICE` | Refer to `deviceName` capability in chart
1145
- `DEVICE_TYPE` | Must be set to `phone` or `tablet`
1146
- `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`)
1147
- `ORIENTATION` | [Optional] Set to `portrait` or `landscape`
1148
-
1149
-
1150
- #### Remote desktop browsers on the Gridlastic service
1151
-
1152
- For remotely hosted desktop web browsers on the Gridlastic service, the following **Environment Variables** must be set as described in
1153
- the table below. Refer to the [Gridlastic Selenium Grid Test Environments](https://www.gridlastic.com/test-environments.html) for information
1154
- regarding the specific capabilities.
1155
-
1156
- **Environment Variable** | **Description**
1157
- --------------- | ----------------
1158
- `WEB_BROWSER` | Must be set to `gridlastic`
1159
- `GL_USERNAME` | Must be set to your Gridlastic account user name
1160
- `GL_AUTHKEY` | Must be set to your Gridlastic account access key
1161
- `GL_SUBDOMAIN` | Must be set to your Gridlastic subdomain
1162
- `GL_OS` | Refer to `platform` capability in chart
1163
- `GL_BROWSER` | Refer to `browserName` capability in chart
1164
- `GL_VERSION` | Refer to `version` capability in chart
1165
- `GL_PLATFORM` | Must be set to `windows` when running on Windows operating systems
1166
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1167
- `VIDEO_URL` | [Optional] Video Files Location Endpoint URL shown in the **Your Selenium Grid Credentials** section of the Gridlastic Dashboard
1168
-
1169
-
1085
+ | **Environment Variable** | **Description** |
1086
+ |--------------------------|-------------------------------------------------------------------------------------------------------------------|
1087
+ | `WEB_BROWSER` | Must be set to `testingbot` |
1088
+ | `TB_USERNAME` | Must be set to your TestingBot account user name |
1089
+ | `TB_AUTHKEY` | Must be set to your TestingBot account access key |
1090
+ | `TB_OS` | Refer to `platform` capability in chart |
1091
+ | `TB_BROWSER` | Refer to `browserName` capability in chart |
1092
+ | `TB_VERSION` | Refer to `version` capability in chart |
1093
+ | `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`) |
1094
+ | `RESOLUTION` | [Optional] Possible values: `800x600`, `1024x768`, `1280x960`, `1280x1024`, `1600x1200`, `1920x1200`, `2560x1440` |
1095
+ | `BROWSER_SIZE` | [Optional] Specify width, height of browser window |
1170
1096
 
1171
1097
  #### Remote desktop browsers on the LambdaTest service
1172
1098
 
@@ -1174,21 +1100,20 @@ For remotely hosted desktop web browsers on the LambdaTest service, the followin
1174
1100
  below. Use the Configuration Wizard on the [Selenium Desired Capabilities Generator](https://www.lambdatest.com/capabilities-generator/) to obtain
1175
1101
  information regarding the specific capabilities.
1176
1102
 
1177
- **Environment Variable** | **Description**
1178
- --------------- | ----------------
1179
- `WEB_BROWSER` | Must be set to `lambdatest`
1180
- `LT_USERNAME` | Must be set to your LambdaTest account user name or email address
1181
- `LT_AUTHKEY` | Must be set to your LambdaTest account access key
1182
- `LT_OS` | Refer to `platform` capability in the sample script of the Wizard
1183
- `LT_BROWSER` | Refer to `browserName` capability in the sample script of the Wizard
1184
- `LT_VERSION` | Refer to `version` capability in chart
1185
- `RESOLUTION` | [Optional] Refer to supported `resolution` capability in the sample script of the Wizard
1186
- `BROWSER_SIZE` | [Optional] Specify width, height of browser window
1187
- `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
1188
- `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only
1189
- `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only
1190
- `CONSOLE_LOGS` | [Optional] Used to capture browser console logs.
1191
-
1103
+ | **Environment Variable** | **Description** |
1104
+ |--------------------------|------------------------------------------------------------------------------------------|
1105
+ | `WEB_BROWSER` | Must be set to `lambdatest` |
1106
+ | `LT_USERNAME` | Must be set to your LambdaTest account user name or email address |
1107
+ | `LT_AUTHKEY` | Must be set to your LambdaTest account access key |
1108
+ | `LT_OS` | Refer to `platform` capability in the sample script of the Wizard |
1109
+ | `LT_BROWSER` | Refer to `browserName` capability in the sample script of the Wizard |
1110
+ | `LT_VERSION` | Refer to `version` capability in chart |
1111
+ | `RESOLUTION` | [Optional] Refer to supported `resolution` capability in the sample script of the Wizard |
1112
+ | `BROWSER_SIZE` | [Optional] Specify width, height of browser window |
1113
+ | `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
1114
+ | `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only |
1115
+ | `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only |
1116
+ | `CONSOLE_LOGS` | [Optional] Used to capture browser console logs. |
1192
1117
 
1193
1118
  ### Using Browser specific Profiles in cucumber.yml
1194
1119
 
@@ -1197,10 +1122,9 @@ target web browsers is to create browser specific **Profiles** that set the appr
1197
1122
  in your `cucumber.yml` file.
1198
1123
 
1199
1124
  Below is a list of Cucumber **Profiles** for supported locally and remotely hosted desktop and mobile web browsers (put these in in your
1200
- `cucumber.yml` file). Before you can use the BrowserStack, CrossBrowserTesting, Sauce Labs, TestingBot, Gridlastic or LambdaTest services, you
1201
- will need to replace the *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account and authorization code for
1202
- the cloud service(s) that you intend to connect with. When using the Gridlastic service, you will also need replace the *INSERT SUBDOMAIN HERE*
1203
- placeholder text with the Subdomain specified on the Grid Configuration Parameters section of the Gridlastic Dashboard.
1125
+ `cucumber.yml` file). Before you can use the BrowserStack, SauceLabs, TestingBot or LambdaTest services, you will need to replace the
1126
+ *INSERT USER NAME HERE* and *INSERT PASSWORD HERE* placeholder text with your user account and authorization code for the cloud service(s)
1127
+ that you intend to connect with.
1204
1128
 
1205
1129
 
1206
1130
  <% desktop = "--tags @desktop --require features BROWSER_TILE=true BROWSER_SIZE=1500,1000" %>
@@ -1447,62 +1371,6 @@ placeholder text with the Subdomain specified on the Grid Configuration Paramete
1447
1371
  bs_nexus9: --profile bs_android_device BS_DEVICE="Google Nexus 9" DEVICE_TYPE=tablet
1448
1372
 
1449
1373
 
1450
- #==============
1451
- # profiles for remotely hosted web browsers on the CrossBrowserTesting service
1452
- #==============
1453
-
1454
- crossbrowser: WEB_BROWSER=crossbrowser CB_USERNAME="<INSERT USER NAME HERE>" CB_AUTHKEY="<INSERT PASSWORD HERE>"
1455
- cb_desktop: --profile crossbrowser <%= desktop %>
1456
- cb_mobile: --profile crossbrowser <%= mobile %>
1457
-
1458
- # CrossBrowserTesting OS X desktop browser profiles
1459
- cb_osx: --profile cb_desktop RESOLUTION="1920x1200"
1460
- cb_macos_sierra: --profile cb_osx CB_OS="Mac10.12"
1461
- cb_chrome_sierra: --profile cb_macos_sierra CB_BROWSER="Chrome53x64"
1462
- cb_safari_sierra: --profile cb_macos_sierra CB_BROWSER="Safari10"
1463
-
1464
- cb_osx_el_capitan: --profile cb_osx CB_OS="Mac10.11"
1465
- cb_ff_el_cap: --profile cb_osx_el_capitan CB_BROWSER="FF46"
1466
- cb_chrome_el_cap: --profile cb_osx_el_capitan CB_BROWSER="Chrome48x64"
1467
- cb_safari_el_cap: --profile cb_osx_el_capitan CB_BROWSER="Safari9"
1468
-
1469
- cb_osx_yosemite: --profile cb_osx CB_OS="Mac10.10"
1470
- cb_ff_yos: --profile cb_osx_yosemite CB_BROWSER="FF46"
1471
- cb_chrome_yos: --profile cb_osx_yosemite CB_BROWSER="Chrome48x64"
1472
- cb_safari_yos: --profile cb_osx_yosemite CB_BROWSER="Safari8"
1473
-
1474
- # CrossBrowserTesting Windows desktop browser profiles
1475
- cb_win: --profile cb_desktop RESOLUTION="1920x1080"
1476
- cb_win8: --profile cb_win CB_OS="Win8"
1477
- cb_win10: --profile cb_win CB_OS="Win10"
1478
- cb_ff_win8: --profile cb_win8 CB_BROWSER="FF46"
1479
- cb_ff_win10: --profile cb_win10 CB_BROWSER="FF46"
1480
- cb_chrome_win8: --profile cb_win8 CB_BROWSER="Chrome48x64"
1481
- cb_chrome_win10: --profile cb_win10 CB_BROWSER="Chrome48x64"
1482
- cb_edge_win10: --profile cb_win10 CB_BROWSER="Edge20"
1483
-
1484
- cb_ie11_win8: --profile cb_win8 CB_BROWSER="IE11"
1485
- cb_ie10_win8: --profile cb_win8 CB_BROWSER="IE10"
1486
- cb_ie11_win10: --profile cb_win10 CB_BROWSER="IE11"
1487
-
1488
- # CrossBrowserTesting iOS mobile browser profiles
1489
- cb_iphone6s_plus: --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6sPlus-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="1242x2208"
1490
- cb_iphone6s: --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6s-iOS9sim" CB_BROWSER="MblSafari9.0" RESOLUTION="750x1334"
1491
- cb_iphone6_plus: --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6Plus-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="1242x2208"
1492
- cb_iphone6: --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone6-iOS8sim" CB_BROWSER="MblSafari8.0" RESOLUTION="750x1334"
1493
- cb_iphone5s: --profile cb_mobile DEVICE_TYPE=phone CB_PLATFORM="iPhone5s-iOS7sim" CB_BROWSER="MblSafari7.0" RESOLUTION="640x1136"
1494
- cb_ipad_pro: --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadPro-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2732x2048"
1495
- cb_ipad_air2: --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadAir2-iOS9Sim" CB_BROWSER="MblSafari9.0" RESOLUTION="2048x1536"
1496
- cb_ipad_air: --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadAir-iOS8Sim" CB_BROWSER="MblSafari8.0" RESOLUTION="2048x1536"
1497
- cb_ipad_mini: --profile cb_mobile DEVICE_TYPE=tablet CB_PLATFORM="iPadMiniRetina-iOS7Sim" CB_BROWSER="MblSafari7.0" RESOLUTION="2048x1536"
1498
-
1499
- # CrossBrowserTesting Android mobile browser profiles
1500
- cb_nexus7: --profile cb_mobile CB_PLATFORM="Nexus7-And42" CB_BROWSER="MblChrome37" RESOLUTION="800x1280"
1501
- cb_galaxy_tab2: --profile cb_mobile CB_PLATFORM="GalaxyTab2-And41" CB_BROWSER="MblChrome38" RESOLUTION="1280x800"
1502
- cb_galaxy_s5: --profile cb_mobile CB_PLATFORM="GalaxyS5-And44" CB_BROWSER="MblChrome35" RESOLUTION="1080x1920"
1503
- cb_galaxy_s4: --profile cb_mobile CB_PLATFORM="GalaxyS4-And42" CB_BROWSER="MblChrome33" RESOLUTION="1080x1920"
1504
-
1505
-
1506
1374
  #==============
1507
1375
  # profiles for remotely hosted web browsers on the SauceLabs service
1508
1376
  #==============
@@ -1574,57 +1442,6 @@ placeholder text with the Subdomain specified on the Grid Configuration Paramete
1574
1442
  tb_ie10_win8: --profile tb_win8 TB_BROWSER="internet explorer" TB_VERSION="10"
1575
1443
  tb_ie11_win10: --profile tb_win10 TB_BROWSER="internet explorer" TB_VERSION="11"
1576
1444
  tb_edge_win10: --profile tb_win10 TB_BROWSER="microsoftedge" TB_VERSION="14"
1577
-
1578
- # TestingBot iOS mobile browser profiles
1579
- tb_ios: --profile tb_mobile TB_OS="MAC" TB_BROWSER="safari" TB_PLATFORM="iOS"
1580
- tb_iphone6s_plus_10: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6s Plus"
1581
- tb_iphone6s_plus_93: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3" TB_DEVICE="iPhone 6s Plus"
1582
- tb_iphone6_plus_10: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6 Plus"
1583
- tb_iphone6_plus_93: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3" TB_DEVICE="iPhone 6 Plus"
1584
- tb_iphone6s_10: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 6s"
1585
- tb_iphone6s_93: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3" TB_DEVICE="iPhone 6s"
1586
- tb_iphone5s_10: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="10.0" TB_DEVICE="iPhone 5s"
1587
- tb_iphone5s_93: --profile tb_ios DEVICE_TYPE=phone TB_VERSION="9.3" TB_DEVICE="iPhone 5s"
1588
- tb_ipad_pro_10: --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="10.0" TB_DEVICE="iPad Pro"
1589
- tb_ipad_pro_93: --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="9.3" TB_DEVICE="iPad Pro"
1590
- tb_ipad_air2_10: --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="10.0" TB_DEVICE="iPad Air 2"
1591
- tb_ipad_air2_93: --profile tb_ios DEVICE_TYPE=tablet TB_VERSION="9.3" TB_DEVICE="iPad Air 2"
1592
-
1593
- # TestingBot Android mobile browser profiles
1594
- tb_android: --profile tb_mobile TB_OS="ANDROID" TB_BROWSER="browser" TB_PLATFORM="Android"
1595
- tb_nexus_s: --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus S"
1596
- tb_nexus_1: --profile tb_android TB_VERSION="5.0" TB_DEVICE="Nexus 1"
1597
- tb_nexus_4: --profile tb_android TB_VERSION="6.0" TB_DEVICE="Nexus 4"
1598
- tb_galaxy_nexus: --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy Nexus"
1599
- tb_galaxy_s4: --profile tb_android TB_VERSION="4.4" TB_DEVICE="Galaxy S4"
1600
- tb_galaxy_s5: --profile tb_android TB_VERSION="5.0" TB_DEVICE="Galaxy S5"
1601
- tb_galaxy_s6: --profile tb_android TB_VERSION="6.0" TB_DEVICE="Galaxy S6"
1602
-
1603
-
1604
- #==============
1605
- # profiles for remotely hosted web browsers on the Gridlastic service
1606
- #==============
1607
-
1608
- gridlastic: WEB_BROWSER=gridlastic GL_USERNAME="<INSERT USER NAME HERE>" GL_AUTHKEY="<INSERT PASSWORD HERE>" GL_SUBDOMAIN="<INSERT SUBDOMAIN HERE>"
1609
- gl_video: RECORD_VIDEO="True" VIDEO_URL="<INSERT VIDEO URL HERE>"
1610
- gl_desktop: --profile gridlastic --profile gl_video <%= desktop %>
1611
-
1612
- # Gridlastic Windows desktop browser profiles
1613
- gl_windows: --profile gl_desktop GL_PLATFORM="windows"
1614
- gl_win8: --profile gl_windows GL_OS="WIN8"
1615
- gl_win8_1: --profile gl_windows GL_OS="WIN8_1"
1616
- gl_win10: --profile gl_windows GL_OS="WIN10"
1617
- gl_ff_win8: --profile gl_win8_1 GL_BROWSER="firefox" GL_VERSION="59"
1618
- gl_ff_win10: --profile gl_win10 GL_BROWSER="firefox" GL_VERSION="59"
1619
- gl_chrome_win8: --profile gl_win8_1 GL_BROWSER="chrome" GL_VERSION="latest"
1620
- gl_chrome_win10: --profile gl_win10 GL_BROWSER="chrome" GL_VERSION="latest"
1621
-
1622
- gl_ie11_win8: --profile gl_win8_1 GL_BROWSER="internet explorer" GL_VERSION="11"
1623
- gl_ie10_win8: --profile gl_win8 GL_BROWSER="internet explorer" GL_VERSION="10"
1624
- gl_ie11_win10: --profile gl_win10 GL_BROWSER="internet explorer" GL_VERSION="11"
1625
-
1626
- # Gridlastic Linux desktop browser profiles
1627
- gl_chrome_linux: --profile gl_desktop GL_OS="LINUX" GL_BROWSER="chrome" GL_VERSION="latest"
1628
1445
 
1629
1446
 
1630
1447
  #==============
@@ -1702,7 +1519,7 @@ landscape orientation running on the BrowserStack service:
1702
1519
 
1703
1520
  ## Web Test Automation Framework Implementation
1704
1521
 
1705
- <img src="https://i.imgur.com/qw48Kkf.jpg" width="1024" alt="Web Framework Overview" title="Web Framework Overview">
1522
+ ![TestCentricity Web Framework Overview](/doc/images/TC_Web.jpg)
1706
1523
 
1707
1524
 
1708
1525