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

• The mcr.microsoft.com/playwright docker image no longer contains Python. Please use mcr.microsoft.com/playwright/python
  as a Playwright-ready docker image with pre-installed Python.
• Playwright now supports large file uploads (100s of MBs) via Locator.set_input_files 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 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