Starstruk Logo MarkStarstruk

v1.56.0

microsoft/playwrightv1.56.0Oct 6, 2025by agg23

AI Summary

This release introduces Playwright Agents, a suite of tools to guide LLMs in building tests, alongside new APIs for console and network monitoring. It also enhances the HTML reporter and UI Mode with new configuration options and deprecates an event handler.

Key Highlights

  • Introduces Playwright Agents (planner, generator, healer) for LLM-guided testing
  • Adds new APIs: page.consoleMessages(), page.pageErrors(), page.requests(), and --test-list CLI flags
  • Enhances HTML reporter: disable 'Copy prompt', merge files, and mirror --update-snapshots
  • Deprecates browserContext.on('backgroundpage') event

Breaking Changes

  • Event browserContext.on('backgroundpage') has been deprecated

New Features

  • Playwright Agents initialization via npx playwright init-agents
  • New methods for retrieving console messages and network requests
  • Test list CLI options for manual test specification
  • HTML reporter options for UI and mirroring
  • Aria snapshots now render and compare input placeholder

Full Release Notes

## Playwright Agents

Introducing Playwright Agents, three custom agent definitions designed to guide LLMs through the core process of building a Playwright test:
* **🎭 planner** explores the app and produces a Markdown test plan
* **🎭 generator** transforms the Markdown plan into the Playwright Test files
* **🎭 healer** executes the test suite and automatically repairs failing tests

Run `npx playwright init-agents` with your client of choice to generate the latest agent definitions:

```bash
# Generate agent files for each agentic loop
# Visual Studio Code
npx playwright init-agents --loop=vscode
# Claude Code
npx playwright init-agents --loop=claude
# opencode
npx playwright init-agents --loop=opencode
```

> [!NOTE]
> VS Code v1.105 (currently on the VS Code Insiders channel) is needed for the agentic experience in VS Code. It will become stable shortly, we are a bit ahead of times with this functionality!


[Learn more about Playwright Agents](https://playwright.dev/docs/test-agents)

## New APIs
- New methods [page.consoleMessages()](https://playwright.dev/docs/api/class-page#page-console-messages) and [page.pageErrors()](https://playwright.dev/docs/api/class-page#page-page-errors) for retrieving the most recent console messages from the page
- New method [page.requests()](https://playwright.dev/docs/api/class-page#page-requests) for retrieving the most recent network requests from the page
- Added [`--test-list` and `--test-list-invert`](https://playwright.dev/docs/test-cli#test-list) to allow manual specification of specific tests from a file

## UI Mode and HTML Reporter
- Added option to `'html'` reporter to disable the "Copy prompt" button
- Added option to `'html'` reporter and UI Mode to merge files, collapsing test and describe blocks into a single unified list
- Added option to UI Mode mirroring the `--update-snapshots` options
- Added option to UI Mode to run only a single worker at a time

## Breaking Changes
- Event [browserContext.on('backgroundpage')](https://playwright.dev/docs/api/class-browsercontext#browser-context-event-background-page) has been deprecated and will not be emitted. Method [browserContext.backgroundPages()](https://playwright.dev/docs/api/class-browsercontext#browser-context-background-pages) will return an empty list

## Miscellaneous
- Aria snapshots render and compare `input` `placeholder`
- Added environment variable `PLAYWRIGHT_TEST` to Playwright worker processes to allow discriminating on testing status

## Browser Versions
- Chromium 141.0.7390.37
- Mozilla Firefox 142.0.1
- WebKit 26.0