Files
magnus919_agent-skills/playwright/references/00-source-index.md
T
Magnus HedemarkGitHubfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
ac1beb117d feat(skill): add Playwright skill (E2E testing + scraping + headless browsing) (#264)
Add ONE tool skill for Playwright: SKILL.md covering E2E test authoring,
selector robustness, network interception/mocking, parallel workers, CI
integration, scraping/headless patterns, accessibility snapshot checks, and
headed debugging; scripts/pwrun (agent-first smoke harness with --json,
fixture-tested); templates/ test-suite scaffold; eight dated references; a
schema-valid evals/evals.json (6 cases); a human-facing README; reverse
routing from qa-methodology and frontend-engineering; top-level README index
entry; and regenerated catalogs (llms.txt, marketplace, codex).

Closes #244.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-08-03 17:59:38 -04:00

44 lines
2.2 KiB
Markdown

# Source Index — Playwright references
> **Last Updated:** 2026-08-03
## Scope
This skill's references are distilled from the official Playwright documentation
and the underlying standards the tool implements (WebDriver BiDi for CDP
migration, WAI-ARIA for the accessibility tree). They are patterns and
decision guidance, not a substitute for the primary sources below.
## Primary sources
| Topic | Source | Accessed |
|---|---|---|
| Test runner, assertions, fixtures, webServer | https://playwright.dev/docs/writing-tests | 2026-08-03 |
| Locators and selector philosophy | https://playwright.dev/docs/locators | 2026-08-03 |
| Network interception (`page.route`) | https://playwright.dev/docs/network | 2026-08-03 |
| Parallelism and sharding | https://playwright.dev/docs/test-parallel | 2026-08-03 |
| CI guides (GitHub Actions, Docker) | https://playwright.dev/docs/ci | 2026-08-03 |
| Traces, HTML/JSON reporters, debugging | https://playwright.dev/docs/trace-viewer | 2026-08-03 |
| Accessibility testing + aria snapshots | https://playwright.dev/docs/accessibility-testing | 2026-08-03 |
| Headless browsers and scraping contexts | https://playwright.dev/docs/api/class-browser | 2026-08-03 |
| Codegen, inspector, slow-mo | https://playwright.dev/docs/codegen | 2026-08-03 |
| `@axe-core/playwright` integration | https://github.com/dequelabs/axe-core-npm | 2026-08-03 |
## Version observations
- **1.40+** — `toMatchAriaSnapshot` is available from 1.49; earlier versions
used the experimental `page.accessibility` API or `expect(...).toHaveAccessibleSnapshot()`.
Pin the version that matches the features this skill references (see `SKILL.md`).
- The JSON reporter output shape changed over time (suite-level `tests` arrays
became `specs[]` with nested `tests[]`). `scripts/pwrun report` parses both
shapes; a fixture for the modern shape lives in `tests/fixtures/sample-report.json`.
## Refresh procedure
Re-verify statements in these references when a new Playwright major lands:
1. Re-read the primary source pages above.
2. Check the changelog for renamed APIs (e.g., `--update-snapshots` flags,
reporter options, `webServer` fields).
3. Update the `Last Updated` line in the changed reference and the version
observations above.