@@ -4,7 +4,7 @@ UI-mapped gherkin tests for the Lace browser extension
4
4
5
5
## Prerequisites
6
6
7
- - Java 8+ (optional if you already have webdriver running on port 4444)
7
+ - Java 8+ (optional if you already have a webdriver running on port 4444)
8
8
- it is only required when using
9
9
with [ selenium-standalone] ( https://github.com/webdriverio/selenium-standalone/blob/main/docs/java-versions.md )
10
10
- On macOS, you can install it easily with homebrew: ` brew install openjdk `
@@ -14,7 +14,7 @@ UI-mapped gherkin tests for the Lace browser extension
14
14
15
15
## Running tests locally
16
16
17
- - Set environment variable with wallet password that is used for test wallets and for decryption
17
+ - Set an environment variable with a wallet password that is used for test wallets and for decryption
18
18
19
19
- ` export WALLET_1_PASSWORD='<password>' `
20
20
@@ -54,8 +54,8 @@ UI-mapped gherkin tests for the Lace browser extension
54
54
- edge
55
55
- firefox
56
56
- does not support network interception or console log collection, so some tests/features are disabled (using ` @skip(browserName="firefox") ` tag)
57
- - works only with Firefox Developer Edition, as the regular version does not allow the use of extensions
58
- - does not support device emulation, so popup mode is simulated by simply resizing the window, which is not an ideal method of simulation
57
+ - it works only with Firefox Developer Edition, as the regular version does not allow the use of extensions
58
+ - it does not support device emulation, so popup mode is simulated by simply resizing the window, which is not an ideal method of simulation
59
59
60
60
## Supported params
61
61
@@ -65,25 +65,25 @@ UI-mapped gherkin tests for the Lace browser extension
65
65
- ` ENV=(mainnet|preprod|preview) ` default = preprod (optional)
66
66
- determines default network used for tests
67
67
- ` WALLET_1_PASSWORD=<password> ` (required)
68
- - password for wallet, should match the password that is used in ` walletConfiguration.ts ` (can be set as an
68
+ - password for wallet should match the password that is used in ` walletConfiguration.ts ` (can be set as an
69
69
environment variable)
70
70
- ` TEST_DAPP_URL=<url> ` (required)
71
71
- url for test DApp (only for DApp Connector tests)
72
72
- ` SERVICE_WORKER_LOGS=true|false ` default=false (optional)
73
73
- enables service worker logs collection
74
74
- not supported for Firefox
75
75
- ` FIREFOX_BINARY=/Applications/Firefox\ Developer\ Edition.app/Contents/MacOS/firefox ` (required for Firefox)
76
- - default path to Firefox Developer Edition binary on MacOS , please adjust to your local setup
76
+ - default path to Firefox Developer Edition binary on macOS , please adjust to your local setup
77
77
78
- ## Run single feature file with params
78
+ ## Run a single feature file with params
79
79
80
80
- ` ENV=preprod WALLET_1_PASSWORD='<password>' yarn wdio run wdio.conf.<browser>.ts --spec SendTransactionSimpleExtended.feature `
81
81
82
82
## Updating walletConfiguration.ts (for development)
83
83
84
84
- decrypt ` walletConfiguration.ts.gpg ` by running ` ./decrypt_secret.sh ` (from the ` packages/e2e-tests ` directory)
85
85
- delete ` packages/e2e-tests/src/support/walletConfiguration.ts.gpg `
86
- - make necessary updates in ` packages/e2e-tests/src/support/walletConfiguration.ts `
86
+ - make the necessary updates in ` packages/e2e-tests/src/support/walletConfiguration.ts `
87
87
- encrypt ` walletConfiguration.ts ` by running ` ./encrypt_secret.sh ` (from the ` packages/e2e-tests ` directory)
88
88
- delete ` packages/e2e-tests/src/support/walletConfiguration.ts `
89
89
@@ -92,13 +92,13 @@ UI-mapped gherkin tests for the Lace browser extension
92
92
- build docker image locally < https://github.com/input-output-hk/lace-hw-testing-toolkit.git > or
93
93
- ` docker pull public.ecr.aws/e8d0p1a5/lw-hw-testing-toolkit:latest ` (you need to be authenticated) and run it
94
94
- After starting docker image (info should be displayed - ` ⚡️ Trezor Device Manipulation API is running at http://localhost:8000 ` )
95
- Tests need to be triggered in 60 sec because emulator shuts down device if there is no action
95
+ Tests need to be triggered in 60 sec because emulator shuts down a device if there is no action
96
96
97
97
## Running tests locally in debug mode using IntelliJ IDEA/WebStorm
98
98
99
- - create new run configuration
99
+ - create a new run configuration
100
100
- type: npm
101
- - fill newly created configuration & environment variables as per attached screenshot
101
+ - fill newly created configuration and environment variables as per attached screenshot
102
102
- ` example: STANDALONE_DRIVER=true;ENV=preprod;TEST_DAPP_URL=<yourUrl>;WALLET_1_PASSWORD=<walletPassword> ` \
103
103
![ debug1.png] ( src/images/readme/debug1.png )
104
104
- make sure you have a chromedriver running on port 4444 (in case of STANDALONE_DRIVER=true)
0 commit comments