testcentricity_web 4.1.3 → 4.1.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +6 -0
- data/Gemfile.lock +112 -0
- data/README.md +126 -86
- data/lib/testcentricity_web/version.rb +1 -1
- data/lib/testcentricity_web/web_core/webdriver_helper.rb +1 -0
- metadata +3 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ee1ff6311bce503168094dbc5546d00419187e6991d67073d590d0cf2dd6beac
|
|
4
|
+
data.tar.gz: 5a776195eb96437187dae63eb12f9e6c1cfe0580811dbc369dc09ac75d76e300
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5c05c61753313054175c4d3ae0a36dabe8fd089a2178918e6d796a26806be5af5d6a5020a55658b1951b4d62adfb63725c610afa4c0b4b4612e6e675de015b62
|
|
7
|
+
data.tar.gz: 279053b4a2323f9089c183bebf286afb6dbb9be22f9bfee0b22264d2810d1ce77e17b33cec22e26d9b1fd6bdd970c41e2cd1cd1c36a11f010fa0d125fd95e80f
|
data/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,12 @@
|
|
|
2
2
|
All notable changes to this project will be documented in this file.
|
|
3
3
|
|
|
4
4
|
|
|
5
|
+
## [4.1.4] - 09-MAR-2022
|
|
6
|
+
|
|
7
|
+
### Fixed
|
|
8
|
+
* `Environ.driver` is now correctly set to `:appium` when target test browser is running on iOS or Android simulators or physical devices.
|
|
9
|
+
|
|
10
|
+
|
|
5
11
|
## [4.1.3] - 08-MAR-2022
|
|
6
12
|
|
|
7
13
|
### Fixed
|
data/Gemfile.lock
ADDED
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
PATH
|
|
2
|
+
remote: .
|
|
3
|
+
specs:
|
|
4
|
+
testcentricity_web (4.1.4)
|
|
5
|
+
appium_lib
|
|
6
|
+
browserstack-local
|
|
7
|
+
capybara (>= 3.1, < 4)
|
|
8
|
+
childprocess
|
|
9
|
+
chronic (= 0.10.2)
|
|
10
|
+
faker
|
|
11
|
+
i18n
|
|
12
|
+
os (~> 1.0)
|
|
13
|
+
selenium-webdriver (>= 4.0, < 5)
|
|
14
|
+
spreadsheet (= 1.1.7)
|
|
15
|
+
test-unit
|
|
16
|
+
virtus
|
|
17
|
+
webdrivers (~> 5.0)
|
|
18
|
+
|
|
19
|
+
GEM
|
|
20
|
+
remote: https://rubygems.org/
|
|
21
|
+
specs:
|
|
22
|
+
addressable (2.8.0)
|
|
23
|
+
public_suffix (>= 2.0.2, < 5.0)
|
|
24
|
+
appium_lib (12.0.0)
|
|
25
|
+
appium_lib_core (~> 5.0.0)
|
|
26
|
+
nokogiri (~> 1.8, >= 1.8.1)
|
|
27
|
+
tomlrb (>= 1.1, < 3.0)
|
|
28
|
+
appium_lib_core (5.0.3)
|
|
29
|
+
faye-websocket (~> 0.11.0)
|
|
30
|
+
selenium-webdriver (~> 4.0)
|
|
31
|
+
axiom-types (0.1.1)
|
|
32
|
+
descendants_tracker (~> 0.0.4)
|
|
33
|
+
ice_nine (~> 0.11.0)
|
|
34
|
+
thread_safe (~> 0.3, >= 0.3.1)
|
|
35
|
+
browserstack-local (1.3.0)
|
|
36
|
+
capybara (3.36.0)
|
|
37
|
+
addressable
|
|
38
|
+
matrix
|
|
39
|
+
mini_mime (>= 0.1.3)
|
|
40
|
+
nokogiri (~> 1.8)
|
|
41
|
+
rack (>= 1.6.0)
|
|
42
|
+
rack-test (>= 0.6.3)
|
|
43
|
+
regexp_parser (>= 1.5, < 3.0)
|
|
44
|
+
xpath (~> 3.2)
|
|
45
|
+
childprocess (4.1.0)
|
|
46
|
+
chronic (0.10.2)
|
|
47
|
+
coercible (1.0.0)
|
|
48
|
+
descendants_tracker (~> 0.0.1)
|
|
49
|
+
concurrent-ruby (1.1.9)
|
|
50
|
+
descendants_tracker (0.0.4)
|
|
51
|
+
thread_safe (~> 0.3, >= 0.3.1)
|
|
52
|
+
eventmachine (1.2.7)
|
|
53
|
+
faker (2.20.0)
|
|
54
|
+
i18n (>= 1.8.11, < 2)
|
|
55
|
+
faye-websocket (0.11.1)
|
|
56
|
+
eventmachine (>= 0.12.0)
|
|
57
|
+
websocket-driver (>= 0.5.1)
|
|
58
|
+
i18n (1.10.0)
|
|
59
|
+
concurrent-ruby (~> 1.0)
|
|
60
|
+
ice_nine (0.11.2)
|
|
61
|
+
matrix (0.4.2)
|
|
62
|
+
mini_mime (1.1.2)
|
|
63
|
+
nokogiri (1.13.3-x86_64-darwin)
|
|
64
|
+
racc (~> 1.4)
|
|
65
|
+
os (1.1.4)
|
|
66
|
+
power_assert (2.0.1)
|
|
67
|
+
public_suffix (4.0.6)
|
|
68
|
+
racc (1.6.0)
|
|
69
|
+
rack (2.2.3)
|
|
70
|
+
rack-test (1.1.0)
|
|
71
|
+
rack (>= 1.0, < 3)
|
|
72
|
+
rake (13.0.6)
|
|
73
|
+
redcarpet (3.5.1)
|
|
74
|
+
regexp_parser (2.2.1)
|
|
75
|
+
rexml (3.2.5)
|
|
76
|
+
ruby-ole (1.2.12.2)
|
|
77
|
+
rubyzip (2.3.2)
|
|
78
|
+
selenium-webdriver (4.1.0)
|
|
79
|
+
childprocess (>= 0.5, < 5.0)
|
|
80
|
+
rexml (~> 3.2, >= 3.2.5)
|
|
81
|
+
rubyzip (>= 1.2.2)
|
|
82
|
+
spreadsheet (1.1.7)
|
|
83
|
+
ruby-ole (>= 1.0)
|
|
84
|
+
test-unit (3.5.3)
|
|
85
|
+
power_assert
|
|
86
|
+
thread_safe (0.3.6)
|
|
87
|
+
tomlrb (2.0.1)
|
|
88
|
+
virtus (2.0.0)
|
|
89
|
+
axiom-types (~> 0.1)
|
|
90
|
+
coercible (~> 1.0)
|
|
91
|
+
descendants_tracker (~> 0.0, >= 0.0.3)
|
|
92
|
+
webdrivers (5.0.0)
|
|
93
|
+
nokogiri (~> 1.6)
|
|
94
|
+
rubyzip (>= 1.3.0)
|
|
95
|
+
selenium-webdriver (~> 4.0)
|
|
96
|
+
websocket-driver (0.7.5)
|
|
97
|
+
websocket-extensions (>= 0.1.0)
|
|
98
|
+
websocket-extensions (0.1.5)
|
|
99
|
+
xpath (3.2.0)
|
|
100
|
+
nokogiri (~> 1.8)
|
|
101
|
+
|
|
102
|
+
PLATFORMS
|
|
103
|
+
x86_64-darwin-21
|
|
104
|
+
|
|
105
|
+
DEPENDENCIES
|
|
106
|
+
bundler
|
|
107
|
+
rake
|
|
108
|
+
redcarpet
|
|
109
|
+
testcentricity_web!
|
|
110
|
+
|
|
111
|
+
BUNDLED WITH
|
|
112
|
+
2.2.1
|
data/README.md
CHANGED
|
@@ -4,11 +4,11 @@
|
|
|
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.x).
|
|
7
|
+
Object Model DSL for use with Cucumber, Capybara (version 3.x), and Selenium-Webdriver (version 4.x). It also facilitates the configuration
|
|
8
|
+
of the appropriate Selenium-Webdriver capabilities required to establish a connection with a local or cloud hosted desktop or mobile web browser.
|
|
8
9
|
|
|
9
10
|
The TestCentricity™ Web gem supports running automated tests against the following web test targets:
|
|
10
|
-
* locally hosted desktop browsers (
|
|
11
|
-
* locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
|
|
11
|
+
* locally hosted desktop browsers (Chrome, Edge, Firefox, Safari, or IE)
|
|
12
12
|
* locally hosted "headless" Chrome, Firefox, or Edge browsers
|
|
13
13
|
* remote desktop and emulated mobile web browsers hosted on Selenium Grid 4 and Dockerized Selenium Grid 4 environments
|
|
14
14
|
* mobile Safari browsers on iOS device simulators or physical iOS devices (using Appium and XCode on OS X)
|
|
@@ -20,6 +20,7 @@ The TestCentricity™ Web gem supports running automated tests against the follo
|
|
|
20
20
|
* [LambdaTest](https://www.lambdatest.com/selenium-automation)
|
|
21
21
|
* web portals utilizing JavaScript front end application frameworks like Ember, React, Angular, and GWT
|
|
22
22
|
* web pages containing HTML5 Video and Audio objects
|
|
23
|
+
* locally hosted emulated iOS Mobile Safari, Android, Windows Phone, or Blackberry mobile browsers (running within a local instance of Chrome)
|
|
23
24
|
|
|
24
25
|
|
|
25
26
|
## What's New
|
|
@@ -1040,7 +1041,7 @@ values from the table below:
|
|
|
1040
1041
|
| `safari` | OS X only |
|
|
1041
1042
|
| `ie` | Windows only (IE version 10.x or greater only) |
|
|
1042
1043
|
|
|
1043
|
-
Refer to **section 8.
|
|
1044
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1044
1045
|
|
|
1045
1046
|
|
|
1046
1047
|
#### Setting desktop browser window size
|
|
@@ -1155,7 +1156,7 @@ To change the emulated device's screen orientation from the default setting, set
|
|
|
1155
1156
|
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
|
|
1156
1157
|
to `chrome`.
|
|
1157
1158
|
|
|
1158
|
-
Refer to **section 8.
|
|
1159
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1159
1160
|
|
|
1160
1161
|
|
|
1161
1162
|
#### User defined mobile device profiles
|
|
@@ -1198,10 +1199,12 @@ For remote desktop and emulated mobile web browsers running on Selenium Grid 4 o
|
|
|
1198
1199
|
| `SELENIUM` | Must be set to `remote` |
|
|
1199
1200
|
| `REMOTE_ENDPOINT` | Must be set to the URL of the Grid hub, which is usually `http://localhost:4444/wd/hub` |
|
|
1200
1201
|
|
|
1201
|
-
Refer to **section 8.
|
|
1202
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1203
|
+
|
|
1202
1204
|
|
|
1205
|
+
### Mobile browsers on Simulators or Physical Devices
|
|
1203
1206
|
|
|
1204
|
-
|
|
1207
|
+
#### Mobile Safari browser on iOS Simulators or iOS Physical Devices
|
|
1205
1208
|
|
|
1206
1209
|
You can run your mobile web tests against the mobile Safari browser on simulated iOS devices or physically connected iOS devices using Appium and XCode on
|
|
1207
1210
|
OS X. You must install Appium, XCode, and the iOS version-specific device simulators for XCode. You must also ensure that the `appium_capybara` gem is
|
|
@@ -1238,12 +1241,12 @@ Once your test environment is properly configured, the following **Environment V
|
|
|
1238
1241
|
|
|
1239
1242
|
The `SHUTDOWN_OTHER_SIMS` environment variable can only be set if you are running Appium Server with the `--relaxed-security` or
|
|
1240
1243
|
`--allow-insecure=shutdown_other_sims` arguments passed when starting it from the command line, or when running the server from the
|
|
1241
|
-
Appium Server GUI app. A security violation error will occur without relaxed
|
|
1244
|
+
Appium Server GUI app. A security violation error will occur without relaxed security enabled.
|
|
1242
1245
|
|
|
1243
|
-
Refer to **section 8.
|
|
1246
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1244
1247
|
|
|
1245
1248
|
|
|
1246
|
-
|
|
1249
|
+
#### Mobile Chrome or Android browsers on Android Studio Virtual Device emulators
|
|
1247
1250
|
|
|
1248
1251
|
You can run your mobile web tests against the mobile Chrome or Android browser on emulated Android devices using Appium and Android Studio on OS X. You
|
|
1249
1252
|
must install Android Studio, the desired Android version-specific virtual device emulators, and Appium. Refer to [this page](http://appium.io/docs/en/drivers/android-uiautomator2/index.html)
|
|
@@ -1260,7 +1263,7 @@ Once your test environment is properly configured, the following **Environment V
|
|
|
1260
1263
|
| `WEB_BROWSER` | Must be set to `appium` |
|
|
1261
1264
|
| `APP_PLATFORM_NAME` | Must be set to `Android` |
|
|
1262
1265
|
| `APP_BROWSER` | Must be set to `Chrome` or `Browser` |
|
|
1263
|
-
| `APP_VERSION` | Must be set to `
|
|
1266
|
+
| `APP_VERSION` | Must be set to `12.0`, or which ever Android OS version you wish to run with the Android Virtual Device |
|
|
1264
1267
|
| `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 |
|
|
1265
1268
|
| `DEVICE_TYPE` | Must be set to `phone` or `tablet` |
|
|
1266
1269
|
| `ORIENTATION` | [Optional] Set to `portrait` or `landscape` |
|
|
@@ -1272,16 +1275,47 @@ Once your test environment is properly configured, the following **Environment V
|
|
|
1272
1275
|
| `NEW_COMMAND_TIMEOUT` | [Optional] Time (in Seconds) that Appium will wait for a new command from the client |
|
|
1273
1276
|
| `CHROMEDRIVER_EXECUTABLE` | [Optional] Absolute local path to webdriver executable |
|
|
1274
1277
|
|
|
1275
|
-
Refer to **section 8.
|
|
1278
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1279
|
+
|
|
1280
|
+
|
|
1281
|
+
#### Starting and stopping Appium Server
|
|
1282
|
+
|
|
1283
|
+
The Appium server must be running prior to invoking Cucumber to run your features/scenarios on mobile simulators or physical
|
|
1284
|
+
device. To programmatically control the starting and stopping of Appium server with the execution of your automated tests, place
|
|
1285
|
+
the code shown below in your `hooks.rb` file.
|
|
1286
|
+
|
|
1287
|
+
BeforeAll do
|
|
1288
|
+
# start Appium Server if APPIUM_SERVER = 'run' and target browser is a mobile simulator or device
|
|
1289
|
+
if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium
|
|
1290
|
+
$server = TestCentricity::AppiumServer.new
|
|
1291
|
+
$server.start
|
|
1292
|
+
end
|
|
1293
|
+
end
|
|
1294
|
+
|
|
1295
|
+
AfterAll do
|
|
1296
|
+
# terminate Appium Server if APPIUM_SERVER = 'run' and target browser is a mobile simulator or device
|
|
1297
|
+
$server.stop if ENV['APPIUM_SERVER'] == 'run' && Environ.driver == :appium && $server.running?
|
|
1298
|
+
# close driver
|
|
1299
|
+
Capybara.page.driver.quit
|
|
1300
|
+
Capybara.reset_sessions!
|
|
1301
|
+
Environ.session_state = :quit
|
|
1302
|
+
end
|
|
1303
|
+
|
|
1276
1304
|
|
|
1305
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1277
1306
|
|
|
1278
|
-
### Remotely hosted desktop and mobile web browsers
|
|
1279
1307
|
|
|
1280
|
-
|
|
1308
|
+
### Remote cloud hosted desktop and mobile web browsers
|
|
1309
|
+
|
|
1310
|
+
You can run your automated tests against remote cloud hosted desktop and mobile web browsers using the BrowserStack, SauceLabs, TestingBot, or
|
|
1281
1311
|
LambdaTest services. If your tests are running against a web site hosted on your local computer (`localhost`), or on a staging server inside
|
|
1282
1312
|
your LAN, you must set the `TUNNELING` Environment Variable to `true`.
|
|
1283
1313
|
|
|
1284
|
-
|
|
1314
|
+
Due to lack of support for Selenium 4.x and the W3C browser capabilities protocol, support for CrossBrowserTesting and Gridlastic cloud hosted
|
|
1315
|
+
Selenium grid services was removed as of version 4.1 of this gem. If your testing requires access to either of those services, or support for
|
|
1316
|
+
Selenium version 3.x, you should use earlier versions of this gem.
|
|
1317
|
+
|
|
1318
|
+
Refer to **section 8.6 (Using Browser specific Profiles in cucumber.yml)** below.
|
|
1285
1319
|
|
|
1286
1320
|
|
|
1287
1321
|
#### Remote desktop browsers on the BrowserStack service
|
|
@@ -1290,24 +1324,24 @@ For remotely hosted desktop web browsers on the BrowserStack service, the follow
|
|
|
1290
1324
|
the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
|
|
1291
1325
|
for information regarding the specific capabilities.
|
|
1292
1326
|
|
|
1293
|
-
| **Environment Variable** | **Description**
|
|
1294
|
-
|
|
1295
|
-
| `WEB_BROWSER` | Must be set to `browserstack`
|
|
1296
|
-
| `BS_USERNAME` | Must be set to your BrowserStack account user name
|
|
1297
|
-
| `BS_AUTHKEY` | Must be set to your BrowserStack account access key
|
|
1298
|
-
| `BS_OS` | Must be set to `OS X` or `Windows`
|
|
1299
|
-
| `BS_OS_VERSION` | Refer to `os_version` capability in chart
|
|
1300
|
-
| `BS_BROWSER` | Refer to `
|
|
1301
|
-
| `BS_VERSION` | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used.
|
|
1302
|
-
| `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. |
|
|
1303
|
-
| `RESOLUTION` | [Optional] Refer to supported screen `resolution` capability in chart
|
|
1304
|
-
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
|
|
1305
|
-
| `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
|
|
1306
|
-
| `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code.
|
|
1307
|
-
| `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only
|
|
1308
|
-
| `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only
|
|
1309
|
-
| `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`)
|
|
1310
|
-
| `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`)
|
|
1327
|
+
| **Environment Variable** | **Description** |
|
|
1328
|
+
|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
1329
|
+
| `WEB_BROWSER` | Must be set to `browserstack` |
|
|
1330
|
+
| `BS_USERNAME` | Must be set to your BrowserStack account user name |
|
|
1331
|
+
| `BS_AUTHKEY` | Must be set to your BrowserStack account access key |
|
|
1332
|
+
| `BS_OS` | Must be set to `OS X` or `Windows` |
|
|
1333
|
+
| `BS_OS_VERSION` | Refer to `os_version` capability in chart |
|
|
1334
|
+
| `BS_BROWSER` | Refer to `browserName` capability in chart |
|
|
1335
|
+
| `BS_VERSION` | [Optional] Refer to `browser_version` capability in chart. If not specified, latest stable version of browser will be used. |
|
|
1336
|
+
| `TUNNELING` | [Optional] Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started. |
|
|
1337
|
+
| `RESOLUTION` | [Optional] Refer to supported screen `resolution` capability in chart |
|
|
1338
|
+
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
|
|
1339
|
+
| `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart |
|
|
1340
|
+
| `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code. |
|
|
1341
|
+
| `ALLOW_POPUPS` | [Optional] Allow popups (`true` or `false`) - for Safari, IE, and Edge browsers only |
|
|
1342
|
+
| `ALLOW_COOKIES` | [Optional] Allow all cookies (`true` or `false`) - for Safari browsers only |
|
|
1343
|
+
| `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`) |
|
|
1344
|
+
| `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`) |
|
|
1311
1345
|
|
|
1312
1346
|
If the BrowserStack Local instance is running (`TUNNELING` Environment Variable is `true`), call the`TestCentricity::WebDriverConnect.close_tunnel` method
|
|
1313
1347
|
upon completion of your test suite to stop the Local instance. Place the code shown below in your `env.rb` or `hooks.rb` file.
|
|
@@ -1324,43 +1358,43 @@ For remotely hosted mobile web browsers on the BrowserStack service, the followi
|
|
|
1324
1358
|
the table below. Refer to the [Browserstack-specific capabilities chart page](https://www.browserstack.com/automate/capabilities?tag=selenium-4)
|
|
1325
1359
|
for information regarding the specific capabilities.
|
|
1326
1360
|
|
|
1327
|
-
| **Environment Variable** | **Description**
|
|
1328
|
-
|
|
1329
|
-
| `WEB_BROWSER` | Must be set to `browserstack`
|
|
1330
|
-
| `BS_USERNAME` | Must be set to your BrowserStack account user name
|
|
1331
|
-
| `BS_AUTHKEY` | Must be set to your BrowserStack account access key
|
|
1332
|
-
| `BS_OS` | Must be set to `ios` or `android`
|
|
1333
|
-
| `BS_BROWSER` | Must be set to `Safari` (for iOS) or `Chrome` (for Android)
|
|
1334
|
-
| `BS_DEVICE` | Refer to `
|
|
1335
|
-
| `BS_REAL_MOBILE` | Set to `true` if running against a real device
|
|
1336
|
-
| `DEVICE_TYPE` | Must be set to `phone` or `tablet`
|
|
1337
|
-
| `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. |
|
|
1338
|
-
| `ORIENTATION` | [Optional] Set to `portrait` or `landscape`
|
|
1339
|
-
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
|
|
1340
|
-
| `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart
|
|
1341
|
-
| `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code.
|
|
1342
|
-
| `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`)
|
|
1343
|
-
| `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`)
|
|
1344
|
-
| `APPIUM_LOGS` | [Optional] Generate Appium logs (`true` or `false`)
|
|
1361
|
+
| **Environment Variable** | **Description** |
|
|
1362
|
+
|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
1363
|
+
| `WEB_BROWSER` | Must be set to `browserstack` |
|
|
1364
|
+
| `BS_USERNAME` | Must be set to your BrowserStack account user name |
|
|
1365
|
+
| `BS_AUTHKEY` | Must be set to your BrowserStack account access key |
|
|
1366
|
+
| `BS_OS` | Must be set to `ios` or `android` |
|
|
1367
|
+
| `BS_BROWSER` | Must be set to `Safari` (for iOS) or `Chrome` (for Android) |
|
|
1368
|
+
| `BS_DEVICE` | Refer to `deviceName` capability in chart |
|
|
1369
|
+
| `BS_REAL_MOBILE` | Set to `true` if running against a real device |
|
|
1370
|
+
| `DEVICE_TYPE` | Must be set to `phone` or `tablet` |
|
|
1371
|
+
| `TUNNELING` | [Optional] Must be `true` if you are testing against internal/local servers (`true` or `false`). If `true`, the BrowserStack Local instance will be automatically started. |
|
|
1372
|
+
| `ORIENTATION` | [Optional] Set to `portrait` or `landscape` |
|
|
1373
|
+
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
|
|
1374
|
+
| `TIME_ZONE` | [Optional] Specify custom time zone. Refer to `browserstack.timezone` capability in chart |
|
|
1375
|
+
| `IP_GEOLOCATION` | [Optional] Specify IP Geolocation. Refer to [IP Geolocation](https://www.browserstack.com/ip-geolocation) to select a country code. |
|
|
1376
|
+
| `SCREENSHOTS` | [Optional] Generate screenshots for debugging (`true` or `false`) |
|
|
1377
|
+
| `NETWORK_LOGS` | [Optional] Capture network logs (`true` or `false`) |
|
|
1378
|
+
| `APPIUM_LOGS` | [Optional] Generate Appium logs (`true` or `false`) |
|
|
1345
1379
|
|
|
1346
1380
|
#### Remote desktop browsers on the Sauce Labs service
|
|
1347
1381
|
|
|
1348
|
-
For remotely hosted desktop web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in
|
|
1349
|
-
|
|
1350
|
-
information regarding the specific capabilities.
|
|
1351
|
-
|
|
1352
|
-
| **Environment Variable** | **Description**
|
|
1353
|
-
|
|
1354
|
-
| `WEB_BROWSER` | Must be set to `saucelabs`
|
|
1355
|
-
| `SL_USERNAME` | Must be set to your Sauce Labs account user name or email address
|
|
1356
|
-
| `SL_AUTHKEY` | Must be set to your Sauce Labs account access key
|
|
1357
|
-
| `DATA_CENTER` | Must be set to your Sauce Labs account Data Center assignment (`us-west-1`, `eu-central-1`, `apac-southeast-1`)
|
|
1358
|
-
| `SL_OS` | Refer to `
|
|
1359
|
-
| `SL_BROWSER` | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `
|
|
1360
|
-
| `SL_VERSION` | Refer to `
|
|
1361
|
-
| `RESOLUTION` | [Optional] Refer to supported `screenResolution` capability in the
|
|
1362
|
-
| `BROWSER_SIZE ` | [Optional] Specify width, height of browser window
|
|
1363
|
-
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`)
|
|
1382
|
+
For remotely hosted desktop web browsers on the Sauce Labs service, the following **Environment Variables** must be set as described in the
|
|
1383
|
+
table below. Use the Selenium 4 selection on the [Platform Configurator page](https://wiki.saucelabs.com/display/DOCS/Platform+Configurator#/)
|
|
1384
|
+
to obtain information regarding the specific capabilities.
|
|
1385
|
+
|
|
1386
|
+
| **Environment Variable** | **Description** |
|
|
1387
|
+
|--------------------------|----------------------------------------------------------------------------------------------------------------------------|
|
|
1388
|
+
| `WEB_BROWSER` | Must be set to `saucelabs` |
|
|
1389
|
+
| `SL_USERNAME` | Must be set to your Sauce Labs account user name or email address |
|
|
1390
|
+
| `SL_AUTHKEY` | Must be set to your Sauce Labs account access key |
|
|
1391
|
+
| `DATA_CENTER` | Must be set to your Sauce Labs account Data Center assignment (`us-west-1`, `eu-central-1`, `apac-southeast-1`) |
|
|
1392
|
+
| `SL_OS` | Refer to `platformName` capability in the Config Script section of the Platform Configurator page |
|
|
1393
|
+
| `SL_BROWSER` | Must be set to `chrome`, `firefox`, `safari`, `internet explorer`, or `MicrosoftEdge` |
|
|
1394
|
+
| `SL_VERSION` | Refer to `browserVersion` capability in the Config Script section of the Platform Configurator page |
|
|
1395
|
+
| `RESOLUTION` | [Optional] Refer to supported `screenResolution` capability in the Config Script section of the Platform Configurator page |
|
|
1396
|
+
| `BROWSER_SIZE ` | [Optional] Specify width, height of browser window |
|
|
1397
|
+
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
|
|
1364
1398
|
|
|
1365
1399
|
#### Remote desktop browsers on the TestingBot service
|
|
1366
1400
|
|
|
@@ -1376,24 +1410,24 @@ regarding the specific capabilities.
|
|
|
1376
1410
|
| `TB_OS` | Refer to `platform` capability in chart |
|
|
1377
1411
|
| `TB_BROWSER` | Refer to `browserName` capability in chart |
|
|
1378
1412
|
| `TB_VERSION` | Refer to `version` capability in chart |
|
|
1379
|
-
| `TUNNELING` | Must be `true` if you are testing against internal/local servers (`true` or `false`)
|
|
1413
|
+
| `TUNNELING` | [Optional] Must be `true` if you are testing against internal/local servers (`true` or `false`) |
|
|
1380
1414
|
| `RESOLUTION` | [Optional] Possible values: `800x600`, `1024x768`, `1280x960`, `1280x1024`, `1600x1200`, `1920x1200`, `2560x1440` |
|
|
1381
1415
|
| `BROWSER_SIZE` | [Optional] Specify width, height of browser window |
|
|
1382
1416
|
|
|
1383
1417
|
#### Remote desktop browsers on the LambdaTest service
|
|
1384
1418
|
|
|
1385
1419
|
For remotely hosted desktop web browsers on the LambdaTest service, the following **Environment Variables** must be set as described in the table
|
|
1386
|
-
below. Use the Configuration Wizard on the [Selenium Desired Capabilities Generator](https://www.lambdatest.com/capabilities-generator/)
|
|
1387
|
-
information regarding the specific capabilities.
|
|
1420
|
+
below. Use the Selenium 4 Configuration Wizard on the [Selenium Desired Capabilities Generator](https://www.lambdatest.com/capabilities-generator/)
|
|
1421
|
+
to obtain information regarding the specific capabilities.
|
|
1388
1422
|
|
|
1389
1423
|
| **Environment Variable** | **Description** |
|
|
1390
1424
|
|--------------------------|------------------------------------------------------------------------------------------|
|
|
1391
1425
|
| `WEB_BROWSER` | Must be set to `lambdatest` |
|
|
1392
1426
|
| `LT_USERNAME` | Must be set to your LambdaTest account user name or email address |
|
|
1393
1427
|
| `LT_AUTHKEY` | Must be set to your LambdaTest account access key |
|
|
1394
|
-
| `LT_OS` | Refer to `
|
|
1428
|
+
| `LT_OS` | Refer to `platformName` capability in the sample script of the Wizard |
|
|
1395
1429
|
| `LT_BROWSER` | Refer to `browserName` capability in the sample script of the Wizard |
|
|
1396
|
-
| `LT_VERSION` | Refer to `
|
|
1430
|
+
| `LT_VERSION` | Refer to `browserVersion` capability in chart |
|
|
1397
1431
|
| `RESOLUTION` | [Optional] Refer to supported `resolution` capability in the sample script of the Wizard |
|
|
1398
1432
|
| `BROWSER_SIZE` | [Optional] Specify width, height of browser window |
|
|
1399
1433
|
| `RECORD_VIDEO` | [Optional] Enable screen video recording during test execution (`true` or `false`) |
|
|
@@ -1499,8 +1533,15 @@ that you intend to connect with.
|
|
|
1499
1533
|
|
|
1500
1534
|
portrait: ORIENTATION=portrait
|
|
1501
1535
|
landscape: ORIENTATION=landscape
|
|
1536
|
+
|
|
1502
1537
|
|
|
1538
|
+
#==============
|
|
1539
|
+
# profile to start Appium Server prior to running mobile browser tests on iOS or Android simulators or physical devices
|
|
1540
|
+
#==============
|
|
1503
1541
|
|
|
1542
|
+
run_appium: APPIUM_SERVER=run
|
|
1543
|
+
|
|
1544
|
+
|
|
1504
1545
|
#==============
|
|
1505
1546
|
# profiles for mobile Safari web browsers hosted within XCode iOS simulator
|
|
1506
1547
|
# NOTE: Requires installation of XCode, iOS version specific target simulators, Appium, and the appium_capybara gem
|
|
@@ -1627,38 +1668,37 @@ To specify a locally hosted target browser using a profile at runtime, you use t
|
|
|
1627
1668
|
invoking Cucumber in the command line. For instance, the following command invokes Cucumber and specifies that a local instance of Firefox
|
|
1628
1669
|
will be used as the target web browser:
|
|
1629
1670
|
|
|
1630
|
-
|
|
1671
|
+
cucumber -p firefox
|
|
1631
1672
|
|
|
1632
1673
|
|
|
1633
|
-
The following command specifies that Cucumber will run tests against an instance of Chrome hosted within a Dockerized Selenium Grid
|
|
1674
|
+
The following command specifies that Cucumber will run tests against an instance of Chrome hosted within a Dockerized Selenium Grid 4
|
|
1675
|
+
environment:
|
|
1634
1676
|
|
|
1635
|
-
|
|
1677
|
+
cucumber -p chrome -p grid
|
|
1636
1678
|
|
|
1637
1679
|
|
|
1638
1680
|
The following command specifies that Cucumber will run tests against a local instance of Chrome, which will be used to emulate an iPad Pro
|
|
1639
1681
|
in landscape orientation:
|
|
1640
1682
|
|
|
1641
|
-
|
|
1683
|
+
cucumber -p ipad_pro -p landscape
|
|
1642
1684
|
|
|
1643
1685
|
|
|
1644
|
-
The following command specifies that Cucumber will run tests against an iPad Pro with iOS version
|
|
1645
|
-
in landscape orientation:
|
|
1686
|
+
The following command specifies that Cucumber will run tests against an iPad Pro (12.9-inch) (5th generation) with iOS version 15.2 in an
|
|
1687
|
+
XCode Simulator in landscape orientation:
|
|
1646
1688
|
|
|
1647
|
-
|
|
1689
|
+
cucumber -p ipad_pro_12_9_15_sim -p landscape
|
|
1648
1690
|
|
|
1649
1691
|
NOTE: Appium must be running prior to executing this command
|
|
1650
1692
|
|
|
1693
|
+
You can ensure that Appium Server is running by including `-p run_appium` in your command line:
|
|
1651
1694
|
|
|
1652
|
-
|
|
1653
|
-
virtual machine on the BrowserStack service:
|
|
1695
|
+
cucumber -p ipad_pro_12_9_15_sim -p landscape -p run_appium
|
|
1654
1696
|
|
|
1655
|
-
cucumber -p bs_safari_mojave
|
|
1656
|
-
|
|
1657
1697
|
|
|
1658
|
-
The following command specifies that Cucumber will run tests against a remotely hosted
|
|
1659
|
-
|
|
1698
|
+
The following command specifies that Cucumber will run tests against a remotely hosted Safari web browser running on a macOS Monterey
|
|
1699
|
+
virtual machine on the BrowserStack service:
|
|
1660
1700
|
|
|
1661
|
-
|
|
1701
|
+
cucumber -p bs_safari_monterey
|
|
1662
1702
|
|
|
1663
1703
|
|
|
1664
1704
|
|
|
@@ -137,6 +137,7 @@ module TestCentricity
|
|
|
137
137
|
Environ.device_os_version = ENV['APP_VERSION']
|
|
138
138
|
Environ.device_orientation = ENV['ORIENTATION'] if ENV['ORIENTATION']
|
|
139
139
|
Capybara.default_driver = :appium
|
|
140
|
+
Environ.driver = :appium
|
|
140
141
|
@endpoint = 'http://localhost:4723/wd/hub' if @endpoint.nil?
|
|
141
142
|
desired_capabilities = {
|
|
142
143
|
platformName: Environ.device_os,
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: testcentricity_web
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 4.1.
|
|
4
|
+
version: 4.1.4
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- A.J. Mrozinski
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: bin
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date: 2022-03-
|
|
11
|
+
date: 2022-03-09 00:00:00.000000000 Z
|
|
12
12
|
dependencies:
|
|
13
13
|
- !ruby/object:Gem::Dependency
|
|
14
14
|
name: bundler
|
|
@@ -258,6 +258,7 @@ files:
|
|
|
258
258
|
- CHANGELOG.md
|
|
259
259
|
- CODE_OF_CONDUCT.md
|
|
260
260
|
- Gemfile
|
|
261
|
+
- Gemfile.lock
|
|
261
262
|
- LICENSE.md
|
|
262
263
|
- README.md
|
|
263
264
|
- Rakefile
|