@piwitests/reporter 0.39.0 → 0.40.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -3
- package/dist/index.d.ts +3 -2
- package/dist/index.js +469 -81
- package/dist/internal/capture/attachments.d.ts +1 -0
- package/dist/internal/capture/attachments.js +1 -0
- package/dist/internal/capture/capture-fixtures.d.ts +47 -1
- package/dist/internal/capture/capture-fixtures.js +309 -73
- package/dist/internal/capture/locator-healing.js +7 -1
- package/dist/internal/capture/pick-on-failure.js +7 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -18,7 +18,7 @@ From your Playwright project, `npx @piwitests/reporter init` installs the report
|
|
|
18
18
|
npx @piwitests/reporter init --server-url http://localhost:3000 --project my-project
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
-
Every step is idempotent (safe to re-run); a config shape it will not rewrite is reported as `manual` with the exact change to make, never mangled. Add `--dry-run` to preview or `--json` for a machine-readable plan an agent can act on. It also installs the [Piwi agent skills](https://piwitests.dev/features/
|
|
21
|
+
Every step is idempotent (safe to re-run); a config shape it will not rewrite is reported as `manual` with the exact change to make, never mangled. Add `--dry-run` to preview or `--json` for a machine-readable plan an agent can act on. It also installs the [Piwi agent skills](https://piwitests.dev/features/agent-skills) so your coding agent can investigate failures, heal locators, and stabilize flaky tests. Run `npx @piwitests/reporter init --help` for all options, or wire it up by hand with the steps below.
|
|
22
22
|
|
|
23
23
|
> The package is `@piwitests/reporter`; its command is `piwi`. Invoke it through the package name (`npx @piwitests/reporter <command>`) so npx resolves this package — `npx piwi` would fetch an unrelated `piwi` from npm. Once the reporter is a project dependency, `npx piwi <command>` resolves the local binary and works too.
|
|
24
24
|
|
|
@@ -57,12 +57,12 @@ Import `test` from this file in your specs instead of `@playwright/test`. A spec
|
|
|
57
57
|
|
|
58
58
|
- **Run history, statuses, errors, traces, reports and live streaming** — with no test-code changes.
|
|
59
59
|
- **Capture fixtures** add slow-endpoint analysis, Web Vitals, console capture, failure-time ARIA snapshots and locator healing.
|
|
60
|
-
- **AI steps** (`page.piwiLocator(...)` / `page.piwiRun(...)`) drive flows in plain English, compiled once and replayed deterministically with zero LLM calls in CI — see [AI steps](https://piwitests.dev/
|
|
60
|
+
- **AI steps** (`page.piwiLocator(...)` / `page.piwiRun(...)`) drive flows in plain English, compiled once and replayed deterministically with zero LLM calls in CI — see [AI steps](https://piwitests.dev/features/ai-steps).
|
|
61
61
|
- **CI-aware** — auto-detects the run label, branch and commit, publishes the run URL back to the pipeline, and shards into a single run. See [CI & sharding](https://piwitests.dev/guide/ci).
|
|
62
62
|
|
|
63
63
|
## Configuration
|
|
64
64
|
|
|
65
|
-
Every option can also be set via a `PIWI_*` environment variable (config wins over env). The full option and env-var reference lives in
|
|
65
|
+
Every option can also be set via a `PIWI_*` environment variable (config wins over env). The full option and env-var reference lives in [Reporter options](https://piwitests.dev/reference/reporter-options); authentication for CI is covered under [API keys](https://piwitests.dev/operate/api-keys).
|
|
66
66
|
|
|
67
67
|
## Requirements
|
|
68
68
|
|
package/dist/index.d.ts
CHANGED
|
@@ -3,6 +3,7 @@ import { PlaywrightTestConfig, Locator, TestType, Page, Fixtures, PlaywrightTest
|
|
|
3
3
|
export { PlaywrightTestConfig } from '@playwright/test';
|
|
4
4
|
export { PiwiFixtures, extendPiwiFixtures, piwiFixtures } from './internal/capture/capture-fixtures.js';
|
|
5
5
|
import '@piwitests/picker-dom';
|
|
6
|
+
import '@piwitests/core/wire';
|
|
6
7
|
|
|
7
8
|
/**
|
|
8
9
|
* Options for configuring the Piwi Dashboard reporter.
|
|
@@ -175,8 +176,8 @@ interface PiwiDashboardOptions {
|
|
|
175
176
|
label?: string;
|
|
176
177
|
/**
|
|
177
178
|
* Keep this run forever: the dashboard's retention never deletes it. Set it
|
|
178
|
-
* for the runs worth keeping, such as release or tag builds.
|
|
179
|
-
* with `PIWI_KEEP=true`.
|
|
179
|
+
* for the runs worth keeping, such as release or tag builds. Defaults to
|
|
180
|
+
* `false`. Can also be set with `PIWI_KEEP=true`.
|
|
180
181
|
*/
|
|
181
182
|
keep?: boolean;
|
|
182
183
|
/** Related issue reference, e.g. `"JIRA-123"` */
|