mirror of
https://github.com/actualbudget/actual.git
synced 2026-04-30 03:23:51 -05:00
65 lines
2.0 KiB
Markdown
65 lines
2.0 KiB
Markdown
Actual on the web
|
|
|
|
## E2E tests
|
|
|
|
E2E (end-to-end) tests use [Playwright](https://playwright.dev/). Running them requires an Actual server to be running either locally or on a remote server.
|
|
|
|
### Functional
|
|
|
|
Running against the local server:
|
|
|
|
```sh
|
|
# Start the development server
|
|
yarn start
|
|
|
|
# Run against the local server (localhost:3001)
|
|
yarn e2e
|
|
```
|
|
|
|
Running against a remote server:
|
|
|
|
```sh
|
|
E2E_START_URL=http://my-remote-server.com yarn e2e
|
|
```
|
|
|
|
### Visual regression
|
|
|
|
Visual regression tests (also known as screenshot tests) check that the visual appearance of the product has not regressed. Each environment has slightly different colors, fonts etc. Mac differs from Windows which differs from Linux. In order to have a stable test environment for visual comparisons - you must use a standartised docker container. This ensures that the tests are always ran in a consistent environment.
|
|
|
|
Prerequisites:
|
|
|
|
- Docker installed
|
|
|
|
#### Running against the local server
|
|
|
|
First start a dev instance:
|
|
|
|
```sh
|
|
HTTPS=true yarn start
|
|
```
|
|
Note the network IP address and port the dev instance is listening on.
|
|
|
|
Next, navigate to the root of your project folder, run the standartised docker container, and launch the visual regression tests from within it.
|
|
|
|
```sh
|
|
# Run docker container
|
|
docker run --rm --network host -v $(pwd):/work/ -w /work/ -it mcr.microsoft.com/playwright:v1.41.1-jammy /bin/bash
|
|
|
|
# If you receive an error such as "docker: invalid reference format", please instead use the following command:
|
|
docker run --rm --network host -v ${pwd}:/work/ -w /work/ -it mcr.microsoft.com/playwright:v1.41.1-jammy /bin/bash
|
|
|
|
# Run the VRT tests: important - they MUST be ran against a HTTPS server. Use the ip and port noted earlier
|
|
E2E_START_URL=https://ip:port yarn vrt
|
|
|
|
# To update snapshots, use the following command:
|
|
E2E_START_URL=https://ip:port yarn vrt --update-snapshots
|
|
```
|
|
|
|
#### Running against a remote server
|
|
|
|
You can also run the tests against a remote server by passing the URL:
|
|
|
|
```sh
|
|
E2E_START_URL=https://my-remote-server.com yarn vrt
|
|
```
|