From aecd677e126ccf1d40cbbe91cb78ee965ef3fe2e Mon Sep 17 00:00:00 2001 From: Ruchika Jha Date: Wed, 28 Jan 2026 11:29:13 +0000 Subject: [PATCH] Add documentation for running UI test cases locally using playwright Closes #45343 Signed-off-by: Ruchika Signed-off-by: Alexander Schwartz Co-authored-by: Alexander Schwartz --- js/apps/admin-ui/CONTRIBUTING.md | 33 ++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/js/apps/admin-ui/CONTRIBUTING.md b/js/apps/admin-ui/CONTRIBUTING.md index 103983d9dae..029de54d9c9 100644 --- a/js/apps/admin-ui/CONTRIBUTING.md +++ b/js/apps/admin-ui/CONTRIBUTING.md @@ -76,3 +76,36 @@ pnpm test:integration -- ``` You can specify the full path or just the test file name. + +### Running Playwright UI + +The Playwright UI provides an interactive environment for developing and debugging UI tests. +Before proceeding, ensure the following prerequisites are met: + +- The Keycloak server is running on `http://localhost:8080`. +- An admin user with login `admin` and password `admin` exists in the master realm. + +Execute the following steps from the repository root. + +1. Navigate to the Admin UI directory: + + ```bash + cd apps/admin-ui + ``` + +2. Install the Playwright browser binaries. This step is required once per local development environment: + + ```bash + pnpm exec playwright install + ``` + +3. Launch the Playwright interactive UI and run tests (Chromium): + + ```bash + pnpm run test:integration -- --project=chromium --ui + ``` + +After executing these steps, the Playwright Test Runner UI will open in a new window. You can select and run individual +tests or test suites interactively. The test runner provides features such as viewing test results, debugging failed +tests, and inspecting the browser state during test execution. +