67 lines
1.8 KiB
Markdown
67 lines
1.8 KiB
Markdown
|
# Metamorph e2e
|
||
|
|
|
||
|
|
End-to-end tests powered by [Playwright](https://playwright.dev/). Each milestone in `tasks/todo.md` should add at least one spec file (`tests/m<N>-*.spec.ts`).
|
||
|
|
|
||
|
|
## One-time setup
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd e2e
|
||
|
|
npm install
|
||
|
|
npm run install-browsers # downloads chromium (uses sudo for system deps)
|
||
|
|
```
|
||
|
|
|
||
|
|
## Running against a live stack
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# 1. Bring the stack up from the repo root:
|
||
|
|
cd .. && make up
|
||
|
|
|
||
|
|
# 2. Run the tests:
|
||
|
|
cd e2e && npm test
|
||
|
|
|
||
|
|
# 3. Open the HTML report:
|
||
|
|
npm run report # opens playwright-report/index.html in your browser
|
||
|
|
```
|
||
|
|
|
||
|
|
Or from the repo root:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
make e2e # runs against the already-up stack
|
||
|
|
make e2e-report # opens the HTML report
|
||
|
|
make e2e-up # one-shot: make up + wait healthy + run tests
|
||
|
|
```
|
||
|
|
|
||
|
|
## Auto-spawn mode
|
||
|
|
|
||
|
|
Set `PW_AUTOSTART=1` to let Playwright spawn `make up` itself before the run:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
PW_AUTOSTART=1 npm test
|
||
|
|
```
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
| Env var | Default | Purpose |
|
||
|
|
|--------------|--------------------------|-----------------------------------------------|
|
||
|
|
| `BASE_URL` | `http://localhost:8080` | The front nginx URL (which proxies `/api/*`) |
|
||
|
|
| `PW_AUTOSTART` | `0` | If `1`, spawn `make up` before the tests |
|
||
|
|
| `CI` | unset | When set, retries=2 and parallel workers=2 |
|
||
|
|
|
||
|
|
## Reports
|
||
|
|
|
||
|
|
- **HTML** : `e2e/playwright-report/index.html`
|
||
|
|
- **JUnit** : `e2e/playwright-report/junit.xml` (CI ingestion)
|
||
|
|
- **Trace** : kept on first retry, opened with `npx playwright show-trace …`
|
||
|
|
|
||
|
|
## Layout
|
||
|
|
|
||
|
|
```
|
||
|
|
e2e/
|
||
|
|
├── tests/
|
||
|
|
│ └── m0-smoke.spec.ts # bootstrap milestone (current)
|
||
|
|
│ └── m<N>-*.spec.ts # one spec per milestone, added as features land
|
||
|
|
├── playwright.config.ts
|
||
|
|
├── tsconfig.json
|
||
|
|
└── package.json
|
||
|
|
```
|