Michael Li
7816772ef2
Adds an end-to-end test for the Admin UI using Playwright. This test uses the Admin UI to create the necessary resources to connect to a target. The test then uses the CLI to start a session and checks in the Admin UI that a session is created
Admin UI e2e tests
This test suite tests the Boundary Admin UI in an end-to-end setting. It was designed to be run in a variety of environments as long as the appropriate environment variables are set. You can choose to spin up your own infrastructure or use Enos to generate it for you.
The test suite uses the Playwright framework.
Getting Started
Setup...
cd boundary-ui/ui/admin
yarn install
npx playwright install # this installs the browsers used by Playwright
Ensure the boundary CLI is available on the path. You can validate this by making sure this
command returns something.
which boundary
Run tests...
export BOUNDARY_ADDR=
export E2E_PASSWORD_ADMIN_LOGIN_NAME=
export E2E_PASSWORD_ADMIN_PASSWORD=
export E2E_PASSWORD_AUTH_METHOD_ID=
... # Tests may have additional variables that it needs
cd boundary-ui/ui/admin
yarn run e2e
Here are some additional commands to assist with debugging.
PWDEBUG=console yarn playwright test --headed --config ./tests/e2e/playwright.config.js login.spec.js
PWDEBUG=console yarn playwright test --headed --config ./tests/e2e/playwright.config.js login.spec.js:13 --debug
PWDEBUG=console yarn playwright test --headed --config ./tests/e2e/playwright.config.js login.spec.js --debug
Developing Tests
It is recommended to use locators that resemble how users interact with the application. getByRole
should be the most prioritized locator as this is the closest way to how users and
accessibility features perceive the page. getByLabel should be used for form fields.