v1.20.0

Highlights

• New options for methods page.screenshot(), locator.screenshot() and elementHandle.screenshot():
  • Option animations: "disabled" rewinds all CSS animations and transitions to a consistent state
  • Option mask: 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

• We now ship a designated Python docker image mcr.microsoft.com/playwright/python. Please switch over to it if you use
  Python. This is the last release that includes Python inside our javascript mcr.microsoft.com/playwright docker image.
• 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.1

Highlights

This patch includes the following bug fixes:

#1167 - [BUG] Task exception was never retrieved when continue_ race with page closed event
microsoft/playwright#12106 - [BUG] Error: EBUSY: resource busy or locked when using volumes in docker-compose with playwright 1.19.0 and mcr.microsoft.com/playwright:v1.15.0-focal
microsoft/playwright#12075 - [Question] After update to 1.19 firefox fails to run

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.19.0

Version 1.19

Locator Updates

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

page.locator("article", has=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.2

Highlights

This patch includes bug fixes for the following issues:

#1117 - [BUG] Fixing a pyee DeprecationWarning

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.18.1

Highlights

This patch includes bug fixes for the following issues:

microsoft/playwright#11447 - [BUG] window.orientation on WebKit is different to what Safari gives you

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.18.0

API Testing

Playwright for Python 1.18 introduces new API Testing that lets you send requests to the server directly from Python!
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
res = page.request.get("http://example.com/foo.json")

Read more in our documentation.

Web-First Assertions

Playwright for Python 1.18 introduces Web-First Assertions.

Consider the following example:

from playwright.sync_api import Page, expect

def test_status_becomes_submitted(page: Page) -> None:
    # ..
    page.click("#submit-button")
    expect(page.locator(".status")).to_have_text("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.drag_to()

• Each locator can now be optionally filtered by the text it contains:

  page.locator("li", has_text="my item").locator("button").click()

  Read more in locator documentation

New APIs & changes

• accept_downloads option now defaults to True.
• sources option to embed sources into traces.

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.frame_locator(selector) or locator.frame_locator(selector) method.

locator = page.frame_locator("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.

• Playwright Test traces now include sources by default (these could be turned off with tracing option)
• 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)