v1.52.0

Highlights

• New method assertThat(locator).containsClass() to ergonomically assert individual class names on the element.

  assertThat(page.getByRole(AriaRole.LISTITEM, new Page.GetByRoleOptions().setName("Ship v1.52")))
    .containsClass("done");

• Aria Snapshots got two new properties: /children for strict matching and /url for links.

  assertThat(locator).matchesAriaSnapshot("""
    - list
      - /children: equal
      - listitem: Feature A
      - listitem:
        - link "Feature B":
          - /url: "https://playwright.dev"
  """);

Miscellaneous

• New option setMaxRedirects in apiRequest.newContext() to control the maximum number of redirects.
• New option setRef in locator.ariaSnapshot() to generate reference for each element in the snapshot which can later be used to locate the element.

Breaking Changes

• Method route.continue() does not allow to override the Cookie header anymore. If a Cookie header is provided, it will be ignored, and the cookie will be loaded from the browser's cookie store. To set custom cookies, use browserContext.addCookies().
• macOS 13 is now deprecated and will no longer receive WebKit updates. Please upgrade to a more recent macOS version to continue benefiting from the latest WebKit improvements.

Browser Versions

• Chromium 136.0.7103.25
• Mozilla Firefox 137.0
• WebKit 18.4

This version was also tested against the following stable channels:

• Google Chrome 135
• Microsoft Edge 135