v1.33.0

Version 1.33.0

Locators Update

• Use Locator.or() to create a locator that matches either of the two locators.
  Consider a scenario where you'd like to click on a "New email" button, but sometimes a security settings dialog shows up instead.
  In this case, you can wait for either a "New email" button, or a dialog and act accordingly:

  Locator newEmail = page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("New"));
  Locator dialog = page.getByText("Confirm security settings");
  assertThat(newEmail.or(dialog)).isVisible();
  if (dialog.isVisible())
    page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Dismiss")).click();
  newEmail.click();

• Use new options setHasNot and setHasNotText in Locator.filter()
  to find elements that do not match certain conditions.

  Locator rowLocator = page.locator("tr");
  rowLocator
      .filter(new Locator.FilterOptions().setHasNotText("text in column 1"))
      .filter(new Locator.FilterOptions().setHasNot(
        page.getByRole(AriaRole.BUTTON,
          new Page.GetByRoleOptions().setName("column 2 button" ))))
      .screenshot();

• Use new web-first assertion LocatorAssertions.isAttached() to ensure that the element
  is present in the page's DOM. Do not confuse with the LocatorAssertions.isVisible() that ensures that
  element is both attached & visible.

New APIs

• Locator.or()
• New option setHasNot in Locator.filter()
• New option setHasNotText in Locator.filter()
• LocatorAssertions.isAttached()
• New option setTimeout in Route.fetch()

Other highlights

• Native support for Apple Silicon - Playwright now runs without Rosetta
• Added Ubuntu 22.04 (Jammy) Docker image

⚠️ Breaking change

• The mcr.microsoft.com/playwright/java:v1.33.0 now serves a Playwright image based on Ubuntu Jammy.
  To use the focal-based image, please use mcr.microsoft.com/playwright/java:v1.33.0-focal instead.

Browser Versions

• Chromium 113.0.5672.53
• Mozilla Firefox 112.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 112
• Microsoft Edge 112

v1.32.0

New APIs

• Chaining existing locator objects, see locator docs for details.
• New options setUpdateMode and setUpdateContent in Page.routeFromHAR() and BrowserContext.routeFromHAR().
• New option name in method Tracing.startChunk().

Browser Versions

• Chromium 112.0.5615.29
• Mozilla Firefox 111.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 111
• Microsoft Edge 111

v1.31.0

New APIs

New assertion assertThat(locator).isInViewport() ensures that locator points to an element that intersects viewport, according to the intersection observer API.

Locator locator = page.getByRole(AriaRole.BUTTON);

// Make sure at least some part of element intersects viewport.
assertThat(locator).isInViewport();

// Make sure element is fully outside of viewport.
assertThat(locator).not().isInViewport();

// Make sure that at least half of the element intersects viewport.
assertThat(locator).isInViewport(new LocatorAssertions.IsInViewportOptions().setRatio(0.5));

Miscellaneous

• DOM snapshots in trace viewer can be now opened in a separate window.
• New option setMaxRedirects for method Route.fetch.
• Official docker images now include Node 18 instead of Node 16.

Browser Versions

• Chromium 111.0.5563.19
• Mozilla Firefox 109.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 110
• Microsoft Edge 110

v1.30.0

🎉 Happy New Year 🎉

Maintenance release with bugfixes and new browsers only.

Browser Versions

• Chromium 110.0.5481.38
• Mozilla Firefox 108.0.2
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 109
• Microsoft Edge 109

v1.29.0

New APIs

• New method Route.fetch:

  page.route("**/api/settings", route -> {
    // Fetch original settings.
    APIResponse response = route.fetch();
    // Force settings theme to a predefined value.
    String body = response.text().replace("\"theme\":\"default\"",
      "\"theme\":\"Solorized\"");
    // Fulfill with modified data.
    route.fulfill(new Route.FulfillOptions().setResponse(response).setBody(body));
  });

• New method Locator.all to iterate over all matching elements:

  // Check all checkboxes!
  Locator checkboxes = page.getByRole(AriaRole.CHECKBOX);
  for (Locator checkbox : checkboxes.all())
    checkbox.check();

• Locator.selectOption matches now by value or label:

  <select multiple>
    <option value="red">Red</div>
    <option value="green">Green</div>
    <option value="blue">Blue</div>
  </select>

  element.selectOption("Red");

Browser Versions

• Chromium 109.0.5414.46
• Mozilla Firefox 107.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 108
• Microsoft Edge 108

v1.28.1

Highlights

This patch release includes the following bug fixes:

#1130 - [Bug] Chaining Locator.getByRole() returns null
microsoft/playwright#18920 - [BUG] [expanded=false] in role selector returns elements without aria-expanded attribute

Browser Versions

• Chromium 108.0.5359.29
• Mozilla Firefox 106.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 107
• Microsoft Edge 107

v1.28.0

Highlights

Playwright Tools

• Live Locators in CodeGen. Generate a locator for any element on the page using "Explore" tool.

New APIs

• locator.blur([options])
• locator.clear([options])

Browser Versions

• Chromium 108.0.5359.29
• Mozilla Firefox 106.0
• WebKit 16.4

This version was also tested against the following stable channels:

• Google Chrome 107
• Microsoft Edge 107

v1.27.1

Highlights

This patch release includes the following bug fixes:

microsoft/playwright#18010 - fix(generator): generate nice locators for arbitrary selectors
microsoft/playwright#17955 - [Question] Github Actions test compatibility check failed mitigation?
microsoft/playwright#17952 - fix: fix typo in treeitem role typing

Browser Versions

• Chromium 107.0.5304.18
• Mozilla Firefox 105.0.1
• WebKit 16.0

This version was also tested against the following stable channels:

• Google Chrome 106
• Microsoft Edge 106

v1.27.0

Highlights

Locators

With these new APIs writing locators is a joy:

• Page.getByText(text, options) to locate by text content.
• Page.getByRole(role, options) to locate by ARIA role, ARIA attributes and accessible name.
• Page.getByLabel(label, options) to locate a form control by associated label's text.
• Page.getByTestId(testId) to locate an element based on its data-testid attribute (other attribute can be configured).
• Page.getByPlaceholder(placeholder, options) to locate an input by placeholder.
• Page.getByAltText(altText, options) to locate an element, usually image, by its text alternative.
• Page.getByTitle(title, options) to locate an element by its title.

page.getByLabel("User Name").fill("John");

page.getByLabel("Password").fill("secret-password");

page.getByRole(AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Sign in")).click();

assertThat(page.getByText("Welcome, John!")).isVisible();

All the same methods are also available on Locator, FrameLocator and Frame classes.

Other highlights

• As announced in v1.25, Ubuntu 18 will not be supported as of Dec 2022. In addition to that, there will be no WebKit updates on Ubuntu 18 starting from the next Playwright release.

Behavior Changes

• expect(locator).hasAttribute(name, value, options) with an empty value does not match missing attribute anymore. For example, the following snippet will succeed when button does not have a disabled attribute.

  assertThat(page.getByRole(AriaRole.BUTTON)).hasAttribute("disabled", "");

Browser Versions

• Chromium 107.0.5304.18
• Mozilla Firefox 105.0.1
• WebKit 16.0

This version was also tested against the following stable channels:

• Google Chrome 106
• Microsoft Edge 106

v1.26.1

Highlights

This patch includes the following bug fixes (they were reported in Playwright Python but manifested themselves in Java too):

microsoft/playwright-python#1561 - [Question]: 'c:\Users\ASUS' is not recognized as an internal or external command, operable program or batch file.
microsoft/playwright-python#1565 - [BUG] AttributeError: 'PlaywrightContextManager' object has no attribute '_playwright

Browser Versions

• Chromium 106.0.5249.30
• Mozilla Firefox 104.0
• WebKit 16.0

This version was also tested against the following stable channels:

• Google Chrome 105
• Microsoft Edge 105