v1.21.0

Highlights

• New experimental role selectors that allow selecting elements by their ARIA role, ARIA attributes and accessible name.

  // Click a button with accessible name "log in"
  page.click("role=button[name='log in']")

  To use role selectors, make sure to pass PLAYWRIGHT_EXPERIMENTAL_FEATURES=1 environment variable.

  Read more in our documentation.

• New scale option in Page.screenshot for smaller sized screenshots.

• New caret option in Page.screenshot to control text caret. Defaults to HIDE.

Behavior Changes

• Playwright now supports large file uploads (100s of MBs) via Locator.setInputFiles API.

Browser Versions

• Chromium 101.0.4951.26
• Mozilla Firefox 98.0.2
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 100
• Microsoft Edge 100

v1.20.1

Highlights

This patch includes the following bug fixes:

microsoft/playwright#12711 - [REGRESSION] Page.screenshot hangs on some sites
microsoft/playwright#12807 - [BUG] Cookies get assigned before fulfilling a response
microsoft/playwright#12821 - [BUG] Chromium: Cannot click, element intercepts pointer events
microsoft/playwright#12887 - [BUG] Locator.count() with _vue selector with Repro
microsoft/playwright#12974 - [BUG] Regression - chromium browser closes during test or debugging session on macos

Browser Versions

• Chromium 101.0.4921.0
• Mozilla Firefox 97.0.1
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 99
• Microsoft Edge 99

v1.20.0

Highlights

• New options for methods page.screenshot(), locator.screenshot() and elementHandle.screenshot():
  • Option ScreenshotAnimations.DISABLED rewinds all CSS animations and transitions to a consistent state
  • Option mask: List<Locator> masks given elements, overlaying them with pink #FF00FF boxes.
• Trace Viewer now shows API testing requests.
• Locator.highlight() visually reveals element(s) for easier debugging.

Announcements

• v1.20 is the last release to receive WebKit update for macOS 10.15 Catalina. Please update macOS to keep using latest & greatest WebKit!

Browser Versions

• Chromium 101.0.4921.0
• Mozilla Firefox 97.0.1
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 99
• Microsoft Edge 99

v1.19.0

Version 1.19

Locator Updates

Locator now supports a has option that makes sure it contains another locator inside:

page.locator("article", new Page.LocatorOptions().setHas(page.locator(".highlight"))).click();

The snippet above will select article that has highlight in it and will press the button in it.
Read more in locator documentation

Other Updates

• New method: Locator.page
• method: Page.screenshot and method: Locator.screenshot now automatically hides blinking caret
• Playwright Codegen now generates locators and frame locators

Browser Versions

• Chromium 100.0.4863.0
• Mozilla Firefox 96.0.1
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 98
• Microsoft Edge 98

v1.18.0

API Testing

Playwright for Java 1.18 introduces new API Testing that lets you send requests to the server directly from Java!

Now you can:

• test your server API
• prepare server side state before visiting the web application in a test
• validate server side post-conditions after running some actions in the browser

To do a request on behalf of Playwright's Page, use new page.request() API:

// Do a GET request on behalf of page
APIResponse res = page.request().get("http://example.com/foo.json");

Read more about it in our API testing guide.

Web-First Assertions

Playwright for Java 1.18 introduces Web-First Assertions.

Consider the following example:

...
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;

public class TestExample {
  ...
  @Test
  void statusBecomesSubmitted() {
    ...
    page.click("#submit-button");
    assertThat(page.locator(".status")).hasText("Submitted");
  }
}

Playwright will be re-testing the node with the selector .status until
fetched Node has the "Submitted" text. It will be re-fetching the node and
checking it over and over, until the condition is met or until the timeout is
reached. You can pass this timeout as an option.

Read more in our documentation.

Locator Improvements

• Locator.dragTo()
• Each locator can now be optionally filtered by the text it contains:

  page.locator("li", new Page.LocatorOptions().setHasText("my item"))
      .locator("button").click();

  Read more in locator documentation

Tracing Improvements

Tracing now can embed Java sources to recorded
traces, using new setSources option.

New APIs & changes

• acceptDownloads option now defaults to true.

Browser Versions

• Chromium 99.0.4812.0
• Mozilla Firefox 95.0
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 97
• Microsoft Edge 97

v1.17.2

Highlights

This patch includes bug fixes for the following issues:

microsoft/playwright#10638 - [BUG] Locator.click -> subtree intercepts pointer events since version 1.17.0
microsoft/playwright#10632 - [BUG] Playwright 1.17.0 -> After clicking the element - I get an error that click action was failed
microsoft/playwright#10627 - [REGRESSION]: Can no longer click Material UI select box
microsoft/playwright#10620 - [BUG] trailing zero width whitespace fails toHaveText

Browser Versions

• Chromium 98.0.4695.0
• Mozilla Firefox 94.0.1
• WebKit 15.4

This version of Playwright was also tested against the following stable channels:

• Google Chrome 96
• Microsoft Edge 96

v1.17.1

Highlights

This patch includes bug fixes for the following issues:

microsoft/playwright#10127 - [BUG] Add Trace Viewer error handling (file not found, not parsable)
microsoft/playwright#10436 - [Bug]: Add hints on how to open trace from HTML report when opened locally
microsoft/playwright#10492 - [Bug]: Fix broken Firefox User-Agent on 'Desktop Firefox' devices

Browser Versions

• Chromium 98.0.4695.0
• Mozilla Firefox 94.0.1
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 96
• Microsoft Edge 96

v1.17.0

Playwright v1.17.0

Frame Locators

Playwright 1.17 introduces frame locators - a locator to the iframe on the page. Frame locators capture the logic sufficient to retrieve the iframe and then locate elements in that iframe. Frame locators are strict by default, will wait for iframe to appear and can be used in Web-First assertions.

Frame locators can be created with either page.FrameLocator(selector) or locator.FrameLocator(selector) method.

Locator locator = page.frameLocator("#my-frame").locator("text=Submit");
locator.click();

Read more at our documentation.

Trace Viewer Update

Playwright Trace Viewer is now available online at https://trace.playwright.dev! Just drag-and-drop your trace.zip file to inspect its contents.

NOTE: trace files are not uploaded anywhere; trace.playwright.dev is a progressive web application that processes traces locally.

• Trace Viewer now shows test name
• New trace metadata tab with browser details
• Snapshots now have URL bar

Ubuntu ARM64 support + more

• Playwright now supports Ubuntu 20.04 ARM64. You can now run Playwright tests inside Docker on Apple M1 and on Raspberry Pi.

New APIs

• Tracing now supports a 'title' option
• Page navigations support a new 'commit' waiting option

Browser Versions

• Chromium 98.0.4695.0
• Mozilla Firefox 94.0.1
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 96
• Microsoft Edge 96

---

v1.16.1

Highlights

This patch includes bug fixes for the following issues:

microsoft/playwright#9692 - [BUG] HTML report shows locator._withElement for locator.evaluate
microsoft/playwright#7818 - [Bug]: dedup snapshot CSS images

Browser Versions

• Chromium 97.0.4666.0
• Mozilla Firefox 93.0
• WebKit 15.4

This version was also tested against the following stable channels:

• Google Chrome 94
• Microsoft Edge 94

---

(1.16.2-1635322350000)

v1.16.0

🎭 Playwright Library

Locator.waitFor

Wait for a locator to resolve to a single element with a given state.
Defaults to the state: 'visible'.

Locator orderSent = page.locator("#order-sent");
orderSent.waitFor();

Read more about Locator.waitFor().

🎭 Playwright Trace Viewer

• run trace viewer with npx playwright show-trace and drop trace files to the trace viewer PWA
• better visual attribution of action targets

Read more about Trace Viewer.

Browser Versions

• Chromium 97.0.4666.0
• Mozilla Firefox 93.0
• WebKit 15.4

This version of Playwright was also tested against the following stable channels:

• Google Chrome 94
• Microsoft Edge 94

---

(1.16.0-1634781227000)