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