Change8

Migrating to Playwright v1.62.0

Version v1.62.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/24/2026

1
Breaking Changes
1
Migration Steps
19
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

fixtures.mount()AbortSignalexpect(page).toHaveScreenshot()expect(locator).toHaveScreenshot()page.screenshot()locator.screenshot()reporter.preprocess()TestRuntestConfig.retryStrategybrowserContext.storageStateCredentialsactionsapiResponse.timing()locator.waitForFunction()page.evaluate()page.addInitScript()browserContext.addInitScript()playwright-clireporter: [['html', { mergeFiles: true }]]

Breaking Changes

Issue #1

Debian 11 is no longer supported. Users on Debian 11 will need to upgrade their operating system or use a supported distribution.

Migration Steps

  1. 1
    When using `page.screenshot()` or `locator.screenshot()`, consider specifying the `type` as 'webp' for WebP format screenshots, with `quality` for lossy compression if desired.

Release Summary

This release introduces a new component testing model with stories and galleries, and allows operations to be cancelled using AbortSignal. It also adds support for WebP screenshots and custom test filtering.

Need More Details?

View the full release notes and all changes for Playwright v1.62.0.

View Full Changelog