●Change8

Migrating to Playwright v1.54.0

Version v1.54.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 7/10/2025

3
Breaking Changes
4
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

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

browserContext.cookiesbrowserContext.addCookiestestResult.annotationstestInfo.annotationsnpx playwright test (CLI option -gv)npx playwright opennode runtime version

Breaking Changes

●Issue #1

`-gv` option removed from `npx playwright test`; use `--grep-invert` instead.

●Issue #2

`npx playwright open` no longer opens the test recorder; use `npx playwright codegen` to launch the recorder.

●Issue #3

Support for Node.js 16 has been removed; projects running on Node 16 must upgrade to a newer Node version.

Migration Steps

  1. 1
    Replace any usage of `-gv` with `--grep-invert` in test command scripts.
  2. 2
    If you relied on `npx playwright open` to launch the test recorder, switch to `npx playwright codegen`.
  3. 3
    Upgrade the runtime to Node.js 18 or newer (preferably Node.js 20) since Node.js 16 is no longer supported.
  4. 4
    Update any code that parses cookie objects to handle the new `partitionKey` field if needed.

Release Summary

This release adds partitioned cookie support, new reporting options, and a CLI flag for user data directories, while removing the `-gv` flag, changing the behavior of `playwright open`, and dropping Node.js 16 support.

Need More Details?

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

View Full Changelog