Highlights

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

    expect(page.get_by_role("listitem", name="Ship v1.52")).to_contain_class("done")

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

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

Miscellaneous

• New option max_redirects in apiRequest.new_context() to control the maximum number of redirects.
• New option ref in locator.aria_snapshot() 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.add_cookies().
• 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