How to test

How to test#

How to test the UI#

There are two commands available to run the elm UI in the project devshell.

  • forge-ui serves the production UI locally.

  • dev-ui serves a UI with generated apps meant to be used for testing purposes and for faster iteration on UI changes.

Basic test#

Run basic tests using Playwright:

dev-ui

test-ui --project=chromium

Note

test-ui is a shell wrapper around playwright test -c ui/tests/e2e without any extra arguments forwarded to that command.

Advanced test configuration#

  • Run tests only using specific browser

test-ui --project=chromium
test-ui --project=firefox --project=mobile

  • Run tests with a single worker

test-ui -j 1

  • Open the playwright web UI to iterate on the tests

test-ui --ui
test-ui --ui-host 127.0.0.1

  • Run the tests using Forge production instance

env BASE_URL=https://ngi.nixos.org test-ui --ui-host 127.0.0.1

Notes#

  • Always use data-testid HTML attributes for stable test selectors.