v1.53.0

microsoft/playwrightv1.53.0Jun 10, 2025by mxschmitt

AI Summary

Enhances the Trace Viewer and HTML reporter with new step visualization, custom titles, and new APIs like locator.describe() and snapshotPath kind options.

Key Highlights

  • New 'Steps' visualization in Trace Viewer and HTML reporter
  • Custom test run title option for HTML reporter
  • New locator.describe() method for describing locators
  • New testInfo.snapshotPath(kind) option
  • playwright install --list lists all installed browsers

New Features

  • Enhanced trace and report visualization
  • Locator description API
  • Snapshot path template control
  • Browser installation listing

Full Release Notes

## Trace Viewer and HTML Reporter Updates

- New Steps in Trace Viewer and HTML reporter: 
  <img src="https://github.com/user-attachments/assets/1963ff7d-4070-41be-a79b-4333176921a2" alt="New Trace Viewer Steps"  height="500">
- New option in `'html'` reporter to set the title of a specific test run:
  
  ```js
  import { defineConfig } from '@playwright/test';
  
  export default defineConfig({
    reporter: [['html', { title: 'Custom test run #1028' }]]
  });
  ```
  
## Miscellaneous
- New option [`kind`](https://playwright.dev/docs/api/class-testinfo#test-info-snapshot-path-option-kind) in [testInfo.snapshotPath()](https://playwright.dev/docs/api/class-testinfo#test-info-snapshot-path) controls which snapshot path template is used.
- New method [locator.describe()](https://playwright.dev/docs/api/class-locator#locator-describe) to describe a locator. Used for trace viewer and reports.
  
  ```js
  const button = page.getByTestId('btn-sub').describe('Subscribe button');
  await button.click();
  ```
  
- `npx playwright install --list` will now list all installed browsers, versions and locations.

## Browser Versions
- Chromium 138.0.7204.4
- Mozilla Firefox 139.0
- WebKit 18.5

This version was also tested against the following stable channels:
- Google Chrome 137
- Microsoft Edge 137