●Change8

Migrating to Playwright v1.60.0

Version v1.60.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 5/11/2026

4
Breaking Changes
5
Migration Steps
36
Affected Symbols

⚠️ Check Your Code

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

tracing.startHartracing.stopHarlocator.dropexpect(page).toMatchAriaSnapshotLocatorPagelocator.ariaSnapshotpage.ariaSnapshottest.abortbrowser.on('context')BrowserContextbrowserContext.on('download')browserContext.on('frameattached')browserContext.on('framedetached')browserContext.on('framenavigated')browserContext.on('pageclose')browserContext.on('pageload')page.getByRolelocator.getByRoleframe.getByRoleframeLocator.getByRoleexpect(locator).toHaveCSSlocator.highlightpage.hideHighlightwebSocketRoute.protocolsbrowserType.connectOverCDPwebError.locationconsoleMessage.locationtestInfoError.errorContextreporter.onErrortestProject.snapshotPathTemplateLocator.ariaRefBrowserContext.exposeBindingPage.exposeBindingBrowserType.connectBrowserType.connectOverCDP

Breaking Changes

●Issue #1

Removed long-deprecated API: `Locator.ariaRef()`. Fix: Use the standard locator.ariaSnapshot() pipeline instead.

●Issue #2

Removed long-deprecated option: `handle` option on BrowserContext.exposeBinding and Page.exposeBinding.

●Issue #3

Removed long-deprecated option: `logger` option on BrowserType.connect and BrowserType.connectOverCDP. Fix: Use tracing instead.

●Issue #4

Removed long-deprecated Context options: `videosPath` / `videoSize`. Fix: Use recordVideo instead.

Migration Steps

  1. 1
    If using Locator.ariaRef(), replace usage with the locator.ariaSnapshot() pipeline.
  2. 2
    If using the 'handle' option on exposeBinding, update usage.
  3. 3
    If using the 'logger' option on BrowserType.connect or BrowserType.connectOverCDP, use tracing instead.
  4. 4
    If using context options 'videosPath' or 'videoSize', use recordVideo instead.
  5. 5
    Update consoleMessage.location() usage to use 'line'/'column' instead of 'lineNumber'/'columnNumber'.

Release Summary

This release introduces significant new APIs for HAR recording, simulated drag-and-drop via locator.drop(), and test abortion via test.abort(). It also removes several long-deprecated APIs and enhances ARIA snapshotting capabilities.

Need More Details?

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

View Full Changelog