2
2
3
3
## Introduction
4
4
This is an internal package for visual automation testing the ESL.
5
- It is designed to be used by the ESL team to test ESL library by checking visual consistency of ` @exadel/esl-webside ` submodule.
5
+ It is designed to be used by the ESL team to test the ESL library by checking the visual consistency of ` @exadel/esl-website ` submodule.
6
6
7
7
## Installation
8
8
9
- There is no extra pre-conditions to develop new visual tests locally,
9
+ There are no extra pre-conditions to develop new visual tests locally,
10
10
everything to start will be already installed with root package installation.
11
11
12
- ** ⚠️ Except for one critical thing: all final snapshots should be created on Linux based OS (Ubuntu latest version is recommended) ⚠️**
12
+ ** ⚠️ Except for one critical thing: all final snapshots should be created on Linux based OS (the latest version of Ubuntu is recommended) ⚠️**
13
13
14
- Visual testing depends on fonts rendering so snapshots created on different OS may be different.
15
- The main (remote) environment for visual testing runs via GitHub Workflows on Ubuntu latest version.
14
+ Visual testing depends on font rendering so snapshots created on different OS may be different.
15
+ The main (remote) environment for visual testing runs via GitHub Workflows on the latest version of Ubuntu .
16
16
17
17
### Creating snapshots and running existing tests on Windows
18
18
@@ -28,7 +28,7 @@ To create snapshots on Windows, you need to use WSL (Windows Subsystem for Linux
28
28
nvm install node@20
29
29
nvm use node@20
30
30
```
31
- 4 . Install cromium browser (https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps#install-google-chrome-for-linux ):
31
+ 4 . Install Chromium browser (https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps#install-google-chrome-for-linux ):
32
32
``` bash
33
33
sudo apt-get update
34
34
sudo apt-get install -y chromium-browser
@@ -38,9 +38,9 @@ To create snapshots on Windows, you need to use WSL (Windows Subsystem for Linux
38
38
sudo apt install libgtk-3-dev libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2
39
39
```
40
40
Note: you might need to restart your subsystem after steps 4 and 5.
41
- 6 . Open project folder via WSL terminal and run ` npm install ` to ensure all dependencies are installed.
41
+ 6 . Open the project folder via WSL terminal and run ` npm install ` to ensure all dependencies are installed.
42
42
7 . Use ` e2e ` package scripts to create snapshots and run tests:
43
- - ` npm run test:e2e ` (in the root package) or ` npm run run ` (in sub-package) to run all tests (missing snapshots will be created automatically)
43
+ - ` npm run test:e2e ` (in the root package) or ` npm run run ` (in the sub-package) to run all tests (missing snapshots will be created automatically)
44
44
- ` npm run test:e2e:update ` (in the root package) or ` npm run run:update ` (in sub-package) to update all snapshots
45
45
46
46
### Creating snapshots and running existing tests on Mac
@@ -49,10 +49,10 @@ TODO: add instructions for Mac OS
49
49
50
50
### Creating snapshots and running existing tests on Linux
51
51
52
- To create snapshots on Linux, you can use any Linux distribution, but Ubuntu latest version is recommended.
52
+ To create snapshots on Linux, you can use any Linux distribution, but the latest version of Ubuntu is recommended.
53
53
54
- 1 . Install ESL root package and all dependencies according to the root package README.md.
55
- 2 . Ensure you have chromium browser installed:
54
+ 1 . Install the ESL root package and all dependencies according to the root package README.md.
55
+ 2 . Ensure you have Chromium browser installed:
56
56
``` bash
57
57
sudo apt-get update
58
58
sudo apt-get install -y chromium-browser
@@ -69,18 +69,17 @@ Use explicit workspace name to run following commands from the root package.
69
69
70
70
- ` npm run run ` - run all visual tests (run server automatically, create missing snapshots)
71
71
- ` npm run run:update ` - update all snapshots (run server automatically)
72
- - ` npm run run:server ` - shortcut to run server for visual tests (uses ` esl-webside ` package)
72
+ - ` npm run run:server ` - shortcut to run server for visual tests (uses ` esl-website ` package)
73
73
- ` npm run run:update:only ` - update all snapshots, does not run server (ensure you run server manually)
74
74
- ` npm run run:server:only ` - run server for visual tests, does not run tests
75
75
76
76
Note: default server port for visual tests is ` 3007 ` .
77
77
78
-
79
78
## Updating snapshots using GitHub project workflow
80
79
81
80
The Automated tests workflow allows you to trigger it manually, it will update all snapshots and commit changes on the branch you specify.
82
81
83
- Make sure you have permissions to run workflows in the ESL repository or ask the ESL Maintainers team to run the proper update for you.
82
+ Make sure you have permission to run workflows in the ESL repository or ask the ESL Maintainers team to run the proper update for you.
84
83
85
84
To trigger the workflow manually, follow these steps:
86
85
0 commit comments