@hmcts/media-viewer 4.2.26-minimist-update → 4.2.26-nodejs-healthcheck-update

package/README.md

@@ -112,7 +112,116 @@ This opens `http://localhost:3000/#/media-viewer`, loads
 and first page. If `MV_SMOKE_PDF_DOCUMENT_ID` is blank, the smoke uses the demo app's
 default AAT PDF document id.
 
-### 5. Create isolated AAT test documents
+### 5. Run Playwright tests
+Media Viewer is starting its Playwright migration with the same runner and
+reporting shape used in MC and MO, scaled to the current smoke coverage. The
+legacy Protractor and CodeceptJS functional packs still exist; new browser
+coverage should be added under `playwright_tests/`.
+
+Current Playwright lanes:
+
+| Lane | Config/project | Command | Scope |
+| --- | --- | --- | --- |
+| Standalone smoke | `playwright.config.ts`, project `smoke` | `yarn test:playwright:smoke` or `yarn test:smoke` | Opens the standalone Media Viewer demo, loads `assets/example.pdf`, and verifies the PDF viewer, page-number control and first rendered page. |
+
+Install Chromium once before local runs when the browser cache is empty:
+
+```
+yarn test:setup:playwright-install-chromium
+```
+
+Run the smoke project against a running standalone demo app. Start the app in
+one terminal:
+
+```
+yarn start
+```
+
+Then run the smoke in another terminal:
+
+```
+yarn test:playwright:smoke
+```
+
+Override the smoke document and case id with `MV_SMOKE_PDF_DOCUMENT_URL` and
+`MV_SMOKE_CASE_ID`. `yarn test:smoke` now runs the Playwright smoke so Jenkins
+CNP uses the same smoke entrypoint style as MC/MO. The previous CodeceptJS smoke
+remains available as `yarn test:smoke:legacy` while migration work continues.
+
+Default Playwright evidence is written under `functional-output/tests`:
+
+| Lane | Odhín | HTML | JUnit | Trace, screenshot and video output |
+| --- | --- | --- | --- | --- |
+| Smoke | `functional-output/tests/playwright-smoke/odhin-report/xui-playwright-smoke.html` | `functional-output/tests/playwright-smoke/html-report/index.html` | `functional-output/tests/playwright-smoke/playwright-smoke-junit.xml` | `functional-output/tests/playwright-smoke/test-results` |
+
+Those are the default local and nightly paths. CNP keeps preview and AAT
+evidence separate under `functional-output/tests/playwright-smoke/preview` and
+`functional-output/tests/playwright-smoke/aat` so results cannot be reused
+across environments.
+
+Reporting behavior follows the MC/MO pattern:
+
+- Odhín is produced through the patched `odhin-reports-playwright` reporter.
+- CI logs Odhín finalisation progress using the same progress reporter as MC/MO.
+- HTML, JUnit and Odhín reporters can run together.
+- Traces, screenshots and videos are kept on failure for diagnostics.
+- `PLAYWRIGHT_SKIP_INSTALL=true` skips browser installation when Jenkins or a
+  local setup step has already installed Chromium.
+- Jenkins CNP and nightly pipelines publish the Odhín HTML reports, publish
+  JUnit XML, and archive the full Playwright output folders.
+
+The Jenkins `YarnBuilder` performs its immutable dependency install before the
+first setup task. The pipeline then installs Puppeteer Chrome once for legacy
+tests and Chromium into the workspace-local `PLAYWRIGHT_BROWSERS_PATH`, and sets
+`PLAYWRIGHT_SKIP_INSTALL=true` so Playwright lanes do not reinstall it.
+
+Useful overrides:
+- `PLAYWRIGHT_BASE_URL` or `TEST_URL`: target application URL, default `http://localhost:3000/`
+- `PLAYWRIGHT_REPORTERS`: comma-separated reporter list, for example `list,html,junit,odhin`
+- `PLAYWRIGHT_DEFAULT_REPORTER`: terminal reporter when `PLAYWRIGHT_REPORTERS` is not set, default `list` locally and `dot` in CI
+- `PLAYWRIGHT_HTML_REPORT`: HTML report folder
+- `PLAYWRIGHT_JUNIT_OUTPUT`: JUnit XML path
+- `PLAYWRIGHT_REPORT_FOLDER`: Odhín report folder
+- `PLAYWRIGHT_REPORT_INDEX_FILENAME`: Odhín report file name
+- `PLAYWRIGHT_REPORT_TITLE`: Odhín report title
+- `PLAYWRIGHT_TEST_OUTPUT_DIR`: traces, screenshots and videos folder
+- `PLAYWRIGHT_SKIP_INSTALL=true`: skip the automatic Chromium install in Playwright scripts
+
+Use this local proof set before pushing Playwright documentation or pipeline
+changes:
+
+```
+yarn install --immutable
+yarn test:setup:playwright-install-chromium
+PLAYWRIGHT_SKIP_INSTALL=true yarn test:playwright:smoke:list
+```
+
+For a smoke behavior proof, start the app in one terminal:
+
+```
+yarn start
+```
+
+Then run the Playwright smoke in another terminal:
+
+```
+PLAYWRIGHT_SKIP_INSTALL=true yarn test:smoke
+```
+
+Migration boundaries:
+
+- Put new native Playwright specs under `playwright_tests/`.
+- Keep screen interactions and reusable locators in page objects under
+  `playwright_tests/pages/`; keep assertions visible in specs.
+- Keep legacy Protractor and CodeceptJS coverage until replacement coverage and
+  Jenkins evidence are agreed.
+- Add stable report output paths for every new Playwright lane so Jenkins can
+  publish Odhín, HTML and JUnit without bespoke stage logic.
+- Prefer Playwright browser-level assertions for viewer readiness; do not treat
+  an error page, blank page, wrong route or service-down page as a valid ready
+  signal.
+
+### 6. Create isolated AAT test documents
 For mutation-heavy functional tests, do not share one document across parallel workers.
 Create fresh AAT DM Store documents through the local API proxy while `yarn start:aat`
 is running:
@@ -130,7 +239,7 @@ This writes:
 The upload path mirrors em-showcase: multipart `files`, `classification=PUBLIC`,
 and civil/probate metadata are posted to `/documents`.
 
-### 6. Run isolated local functional tests
+### 7. Run isolated local functional tests
 With `yarn start:aat` still running, execute the functional groups with separate
 documents and separate reports:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmcts/media-viewer",
-  "version": "4.2.26-minimist-update",
+  "version": "4.2.26-nodejs-healthcheck-update",
   "description": "Media Viewer",
   "keywords": [
     "Angular",