Playwright

New APIs
- Method [browserContext.clearCookies([options])](https://playwright.dev/python/docs/api/class-browsercontext#browser-context-clear-cookies) now supports filters to remove only some cookies.

python
Clear all cookies.
context.clear_cookies()
New: clear cookies with a particular name.
context.clear_cookies(name="session-id")
New: clear cookies for a particular domain.
context.clear_cookies(domain="my-origin.com")


- New method [locator.contentFrame()](https://playwright.dev/python/docs/api/class-locator#locator-content-frame) converts a {link Locator} object to a [FrameLocator](https://playwright.dev/python/docs/api/class-framelocator). This can be useful when you have a [Locator](https://playwright.dev/python/docs/api/class-locator) object obtained somewhere, and later on would like to interact with the content inside the frame.

python
locator = page.locator("iframe[name='embedded']")
...
frame_locator = locator.content_frame
frame_locator.getByRole("button").click()


- New method [frameLocator.owner()](https://playwright.dev/python/docs/api/class-framelocator#frame-locator-owner) converts a [FrameLocator](https://playwright.dev/python/docs/api/class-framelocator) object to a [Locator](https://playwright.dev/python/docs/api/class-locator). This can be useful when you have a [FrameLocator](https://playwright.dev/python/docs/api/class-framelocator) object obtained somewhere, and later on would like to interact with the `iframe` element.

python
frame_locator = page.frame_locator("iframe[name='embedded']")
...
locator = frame_locator.owner
expect(locator).to_be_visible()


- Conda builds are now published for macOS-arm64 and Linux-arm64.

Browser Versions
* Chromium 124.0.6367.8
* Mozilla Firefox 124.0
* WebKit 17.4

This version was also tested against the following stable channels:
* Google Chrome 123
* Microsoft Edge 123

New Locator Handler

New method [page.add_locator_handler(locator, handler)](https://playwright.dev/python/docs/api/class-page#page-add-locator-handler) registers a callback that will be invoked when specified element becomes visible and may block Playwright actions. The callback can get rid of the overlay. Here is an example that closes a cookie dialog when it appears.

python
Setup the handler.
page.add_locator_handler(
page.get_by_role("heading", name="Hej! You are in control of your cookies."),
lambda: page.get_by_role("button", name="Accept all").click(),
)
Write the test as usual.
page.goto("https://www.ikea.com/")
page.get_by_role("link", name="Collection of blue and white").click()
expect(page.get_by_role("heading", name="Light and easy")).to_be_visible()


New APIs
- [page.pdf([options])](https://playwright.dev/python/docs/api/class-page#page-pdf) accepts two new options `tagged` and `outline`.

Announcements
* ⚠️ Ubuntu 18 is not supported anymore.

Browser Versions
* Chromium 123.0.6312.4
* Mozilla Firefox 123.0
* WebKit 17.4

This version was also tested against the following stable channels:
* Google Chrome 122
* Microsoft Edge 123

Highlights

Highlights

https://github.com/microsoft/playwright/issues/29067 - [REGRESSION] Codegen/Recorder: not all clicks are being actioned nor recorded
https://github.com/microsoft/playwright/issues/29019 - [REGRESSION] trace.playwright.dev does not currently support the loading from URL

Browser Versions
* Chromium 121.0.6167.57
* Mozilla Firefox 121.0
* WebKit 17.4

This version was also tested against the following stable channels:
* Google Chrome 120
* Microsoft Edge 120

New APIs
- New method [page.unroute_all()](https://playwright.dev/python/docs/api/class-page#page-unroute-all) removes all routes registered by [page.route()](https://playwright.dev/python/docs/api/class-page#page-route) and [page.route_from_har()](https://playwright.dev/python/docs/api/class-page#page-route-from-har). Optionally allows to wait for ongoing routes to finish, or ignore any errors from them.
- New method [browserContext.unroute_all()](https://playwright.dev/python/docs/api/class-browsercontext#browser-context-unroute-all) removes all routes registered by [browserContext.route()](https://playwright.dev/python/docs/api/class-browsercontext#browser-context-route) and [browserContext.route_from_har()](https://playwright.dev/python/docs/api/class-browsercontext#browser-context-route-from-har). Optionally allows to wait for ongoing routes to finish, or ignore any errors from them.
- New option `style` in [page.screenshot()](https://playwright.dev/python/docs/api/class-page#page-screenshot) and [locator.screenshot()](https://playwright.dev/python/docs/api/class-locator#locator-screenshot) to add custom CSS to the page before taking a screenshot.

Browser Versions
* Chromium 121.0.6167.57
* Mozilla Firefox 121.0
* WebKit 17.4

This version was also tested against the following stable channels:
* Google Chrome 120
* Microsoft Edge 120

Test Generator Update


New tools to generate assertions:
- "Assert visibility" tool generates [expect(locator).to_be_visible()](https://playwright.dev/python/docs/api/class-locatorassertions#locator-assertions-to-be-visible).
- "Assert value" tool generates [expect(locator).to_have_value(value)](https://playwright.dev/python/docs/api/class-locatorassertions#locator-assertions-to-have-value).
- "Assert text" tool generates [expect(locator).to_contain_text(expected)](https://playwright.dev/python/docs/api/class-locatorassertions#locator-assertions-to-contain-text).

Here is an example of a generated test with assertions:

python
from playwright.sync_api import Page, expect

def test_example(page: Page) -> None:
page.goto("https://playwright.dev/")
page.get_by_role("link", name="Get started").click()
expect(page.get_by_label("Breadcrumbs").get_by_role("list")).to_contain_text("Installation")
expect(page.get_by_label("Search")).to_be_visible()
page.get_by_label("Search").click()
page.get_by_placeholder("Search docs").fill("locator")
expect(page.get_by_placeholder("Search docs")).to_have_value("locator");


New APIs
- Option `reason` in [page.close([options])](https://playwright.dev/python/docs/api/class-page#page-close), [browserContext.close([options])](https://playwright.dev/python/docs/api/class-browsercontext#browser-context-close) and [browser.close([options])](https://playwright.dev/python/docs/api/class-browser#browser-close). Close reason is reported for all operations interrupted by the closure.
- Option `firefox_user_prefs` in [browserType.launch_persistent_context(userDataDir[, options])](https://playwright.dev/python/docs/api/class-browsertype#browser-type-launch-persistent-context).

Other Changes
- Method [download.path()](https://playwright.dev/python/docs/api/class-download#download-path) throws an error for failed and cancelled downloads.

Browser Versions
* Chromium 120.0.6099.28
* Mozilla Firefox 119.0
* WebKit 17.4

This version was also tested against the following stable channels:
* Google Chrome 119
* Microsoft Edge 119