54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
# Browser E2E (Playwright)
|
|
|
|
This suite runs browser-based smoke/regression coverage against fixture-hosted admin UI (`tests/fixture/wp-admin/*`).
|
|
|
|
## Run
|
|
|
|
```bash
|
|
tests/e2e/run.sh
|
|
```
|
|
|
|
Or manually:
|
|
|
|
```bash
|
|
scripts/run_fixture_server.sh start
|
|
npm install
|
|
npx playwright install chromium
|
|
E2E_BASE_URL=http://127.0.0.1:8092 npx playwright test
|
|
```
|
|
|
|
Remote admin mode (uses `credentials/.env` `E2E_REMOTE_ADMIN*` vars):
|
|
|
|
```bash
|
|
E2E_REMOTE_ADMIN=1 tests/e2e/run.sh
|
|
```
|
|
|
|
## Specs
|
|
|
|
- `admin-ui-smoke.spec.mjs`
|
|
- page-load smoke for Data Sources, Mailshots, Attachments, PDF Assets.
|
|
- `data-sources.spec.mjs`
|
|
- modal create flow, preview regression guard (`contacts and accounts`), validation failure path.
|
|
- `mailshots-editor.spec.mjs`
|
|
- datasource-driven token/field population, message/PDF overlay editor flows, create mailshot.
|
|
- `run-test-pages.spec.mjs`
|
|
- Run/Test page load checks and API failure-path assertions (`run_mailshot` invalid id, `send_test` blank email).
|
|
- `download-pdf-renewal.spec.mjs`
|
|
- Optional live-data e2e for `renewal_accounts_with_contacts` + `formats/renewals_v4.html`, asserts merged and ZIP downloads both succeed.
|
|
|
|
## Renewal Dataset E2E
|
|
|
|
Run this targeted dataset test with:
|
|
|
|
```bash
|
|
E2E_RENEWAL_ENABLE=1 \
|
|
E2E_RENEWAL_DATASOURCE=renewal_accounts_with_contacts \
|
|
E2E_BASE_URL=http://127.0.0.1:8092 \
|
|
npx playwright test tests/e2e/specs/download-pdf-renewal.spec.mjs
|
|
```
|
|
|
|
## Notes
|
|
|
|
- Tests clean up created Data Source/Mailshot artefacts.
|
|
- This suite is intended as a pre-manual gate before release/deploy.
|