From 133e1ce203daca5f8655181d09ce287bf44b7988 Mon Sep 17 00:00:00 2001 From: "microsoft-playwright-automation[bot]" <203992400+microsoft-playwright-automation[bot]@users.noreply.github.com> Date: Thu, 4 Dec 2025 10:10:24 +0000 Subject: [PATCH] feat(roll): roll to ToT Playwright (04-12-25) --- dotnet/docs/api/class-browsertype.mdx | 20 ++---------------- dotnet/docs/release-notes.mdx | 28 +++++++++++++++++++++++++ java/docs/api/class-browsertype.mdx | 20 ++---------------- java/docs/release-notes.mdx | 28 +++++++++++++++++++++++++ nodejs/docs/api/class-browsertype.mdx | 30 +++------------------------ nodejs/docs/api/class-testoptions.mdx | 2 +- nodejs/docs/release-notes.mdx | 4 ++-- python/docs/api/class-browsertype.mdx | 20 ++---------------- python/docs/release-notes.mdx | 30 +++++++++++++++++++++++++++ 9 files changed, 98 insertions(+), 84 deletions(-) diff --git a/dotnet/docs/api/class-browsertype.mdx b/dotnet/docs/api/class-browsertype.mdx index f6f48e227a8..d44e785d438 100644 --- a/dotnet/docs/api/class-browsertype.mdx +++ b/dotnet/docs/api/class-browsertype.mdx @@ -187,14 +187,6 @@ var browser = await playwright.Chromium.LaunchAsync(new() { - `ChromiumSandbox` [bool]? *(optional)*# Enable Chromium sandboxing. Defaults to `false`. - - `Devtools` [bool]? *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [Headless](/api/class-browsertype.mdx#browser-type-launch-option-headless) option will be set `false`. - `DownloadsPath` [string]? *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -220,7 +212,7 @@ var browser = await playwright.Chromium.LaunchAsync(new() { Close the browser process on SIGTERM. Defaults to `true`. - `Headless` [bool]? *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [Devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `IgnoreAllDefaultArgs` [bool]? *(optional)* Added in: v1.9# If `true`, Playwright does not pass its own configurations args and only uses the ones from [Args](/api/class-browsertype.mdx#browser-type-launch-option-args). Dangerous option; use with care. Defaults to `false`. @@ -364,14 +356,6 @@ await BrowserType.LaunchPersistentContextAsync(userDataDir, options); - `DeviceScaleFactor` [float]? *(optional)*# Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about [emulating devices with device scale factor](../emulation.mdx#devices). - - `Devtools` [bool]? *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [Headless](/api/class-browsertype.mdx#browser-type-launch-persistent-context-option-headless) option will be set `false`. - `DownloadsPath` [string]? *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -416,7 +400,7 @@ await BrowserType.LaunchPersistentContextAsync(userDataDir, options); Specifies if viewport supports touch events. Defaults to false. Learn more about [mobile emulation](../emulation.mdx#devices). - `Headless` [bool]? *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [Devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `HttpCredentials` HttpCredentials? *(optional)*# - `Username` [string] diff --git a/dotnet/docs/release-notes.mdx b/dotnet/docs/release-notes.mdx index bc1d3749aa9..6c4a6eed8d0 100644 --- a/dotnet/docs/release-notes.mdx +++ b/dotnet/docs/release-notes.mdx @@ -7,6 +7,34 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import HTMLCard from '@site/src/components/HTMLCard'; +## Version 1.57 + +### Chrome for Testing + +Starting with this release, Playwright switches from Chromium, to using [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) builds. Both headed and headless browsers are subject to this. Your tests should still be passing after upgrading to Playwright 1.57. + +We're expecting no functional changes to come from this switch. The biggest change is the new icon and title in your toolbar. + +![new and old logo](../images/cft-logo-change.png) + +If you still see an unexpected behaviour change, please [file an issue](https://github.com/microsoft/playwright/issues/new). + +On Arm64 Linux, Playwright continues to use Chromium. + +### Breaking Change + +After 3 years of being deprecated, we removed `Page.Accessibility` from our API. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe. + +### New APIs +- [Worker.Console](/api/class-worker.mdx#worker-event-console) event is emitted when JavaScript within the worker calls one of console API methods, e.g. console.log or console.dir. +- [Locator.Description](/api/class-locator.mdx#locator-description) returns locator description previously set with [Locator.Describe()](/api/class-locator.mdx#locator-describe). +- New option [Steps](/api/class-locator.mdx#locator-click-option-steps) in [Locator.ClickAsync()](/api/class-locator.mdx#locator-click) and [Locator.DragToAsync()](/api/class-locator.mdx#locator-drag-to) that configures the number of `mousemove` events emitted while moving the mouse pointer to the target element. + +### Browser Versions +- Chromium 143.0.7499.4 +- Mozilla Firefox 144.0.2 +- WebKit 26.0 + ## Version 1.56 ### New APIs diff --git a/java/docs/api/class-browsertype.mdx b/java/docs/api/class-browsertype.mdx index 29864e91827..c830fe70c17 100644 --- a/java/docs/api/class-browsertype.mdx +++ b/java/docs/api/class-browsertype.mdx @@ -186,14 +186,6 @@ Browser browser = chromium.launch(new BrowserType.LaunchOptions() - `setChromiumSandbox` [boolean] *(optional)*# Enable Chromium sandboxing. Defaults to `false`. - - `setDevtools` [boolean] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [setHeadless](/api/class-browsertype.mdx#browser-type-launch-option-headless) option will be set `false`. - `setDownloadsPath` [Path] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -219,7 +211,7 @@ Browser browser = chromium.launch(new BrowserType.LaunchOptions() Close the browser process on SIGTERM. Defaults to `true`. - `setHeadless` [boolean] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [setDevtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `setIgnoreAllDefaultArgs` [boolean] *(optional)* Added in: v1.9# If `true`, Playwright does not pass its own configurations args and only uses the ones from [setArgs](/api/class-browsertype.mdx#browser-type-launch-option-args). Dangerous option; use with care. Defaults to `false`. @@ -364,14 +356,6 @@ BrowserType.launchPersistentContext(userDataDir, options); - `setDeviceScaleFactor` [double] *(optional)*# Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about [emulating devices with device scale factor](../emulation.mdx#devices). - - `setDevtools` [boolean] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [setHeadless](/api/class-browsertype.mdx#browser-type-launch-persistent-context-option-headless) option will be set `false`. - `setDownloadsPath` [Path] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -416,7 +400,7 @@ BrowserType.launchPersistentContext(userDataDir, options); Specifies if viewport supports touch events. Defaults to false. Learn more about [mobile emulation](../emulation.mdx#devices). - `setHeadless` [boolean] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [setDevtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `setHttpCredentials` HttpCredentials *(optional)*# - `setUsername` [String] diff --git a/java/docs/release-notes.mdx b/java/docs/release-notes.mdx index e0cb4b53dd6..5b728b4c895 100644 --- a/java/docs/release-notes.mdx +++ b/java/docs/release-notes.mdx @@ -7,6 +7,34 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import HTMLCard from '@site/src/components/HTMLCard'; +## Version 1.57 + +### Chrome for Testing + +Starting with this release, Playwright switches from Chromium, to using [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) builds. Both headed and headless browsers are subject to this. Your tests should still be passing after upgrading to Playwright 1.57. + +We're expecting no functional changes to come from this switch. The biggest change is the new icon and title in your toolbar. + +![new and old logo](../images/cft-logo-change.png) + +If you still see an unexpected behaviour change, please [file an issue](https://github.com/microsoft/playwright/issues/new). + +On Arm64 Linux, Playwright continues to use Chromium. + +### Breaking Change + +After 3 years of being deprecated, we removed `page.accessibility()` from our API. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe. + +### New APIs +- [Worker.onConsole(handler)](/api/class-worker.mdx#worker-event-console) event is emitted when JavaScript within the worker calls one of console API methods, e.g. console.log or console.dir. [Worker.waitForConsoleMessage()](/api/class-worker.mdx#worker-wait-for-console-message) can be used to wait for it. +- [Locator.description()](/api/class-locator.mdx#locator-description) returns locator description previously set with [Locator.describe()](/api/class-locator.mdx#locator-describe). +- New option [setSteps](/api/class-locator.mdx#locator-click-option-steps) in [Locator.click()](/api/class-locator.mdx#locator-click) and [Locator.dragTo()](/api/class-locator.mdx#locator-drag-to) that configures the number of `mousemove` events emitted while moving the mouse pointer to the target element. + +### Browser Versions +- Chromium 143.0.7499.4 +- Mozilla Firefox 144.0.2 +- WebKit 26.0 + ## Version 1.56 ### New APIs diff --git a/nodejs/docs/api/class-browsertype.mdx b/nodejs/docs/api/class-browsertype.mdx index ff8b676b9a9..83bca58e8b6 100644 --- a/nodejs/docs/api/class-browsertype.mdx +++ b/nodejs/docs/api/class-browsertype.mdx @@ -203,14 +203,6 @@ const browser = await chromium.launch({ // Or 'firefox' or 'webkit'. - `chromiumSandbox` [boolean] *(optional)*# Enable Chromium sandboxing. Defaults to `false`. - - `devtools` [boolean] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [headless](/api/class-browsertype.mdx#browser-type-launch-option-headless) option will be set `false`. - `downloadsPath` [string] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -234,7 +226,7 @@ const browser = await chromium.launch({ // Or 'firefox' or 'webkit'. Close the browser process on SIGTERM. Defaults to `true`. - `headless` [boolean] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `ignoreDefaultArgs` [boolean] | [Array]<[string]> *(optional)*# If `true`, Playwright does not pass its own configurations args and only uses the ones from [args](/api/class-browsertype.mdx#browser-type-launch-option-args). If an array is given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`. @@ -384,14 +376,6 @@ await browserType.launchPersistentContext(userDataDir, options); - `deviceScaleFactor` [number] *(optional)*# Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about [emulating devices with device scale factor](../emulation.mdx#devices). - - `devtools` [boolean] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [headless](/api/class-browsertype.mdx#browser-type-launch-persistent-context-option-headless) option will be set `false`. - `downloadsPath` [string] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -434,7 +418,7 @@ await browserType.launchPersistentContext(userDataDir, options); Specifies if viewport supports touch events. Defaults to false. Learn more about [mobile emulation](../emulation.mdx#devices). - `headless` [boolean] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `httpCredentials` [Object] *(optional)*# - `username` [string] @@ -643,14 +627,6 @@ const { chromium } = require('playwright'); // Or 'webkit' or 'firefox'. - `chromiumSandbox` [boolean] *(optional)*# Enable Chromium sandboxing. Defaults to `false`. - - `devtools` [boolean] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [headless](/api/class-browsertype.mdx#browser-type-launch-server-option-headless) option will be set `false`. - `downloadsPath` [string] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -674,7 +650,7 @@ const { chromium } = require('playwright'); // Or 'webkit' or 'firefox'. Close the browser process on SIGTERM. Defaults to `true`. - `headless` [boolean] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `host` [string] *(optional)* Added in: v1.45# Host to use for the web socket. It is optional and if it is omitted, the server will accept connections on the unspecified IPv6 address (::) when IPv6 is available, or the unspecified IPv4 address (0.0.0.0) otherwise. Consider hardening it with picking a specific interface. diff --git a/nodejs/docs/api/class-testoptions.mdx b/nodejs/docs/api/class-testoptions.mdx index 022953ddf98..6e108dd1698 100644 --- a/nodejs/docs/api/class-testoptions.mdx +++ b/nodejs/docs/api/class-testoptions.mdx @@ -454,7 +454,7 @@ export default defineConfig({ Added in: v1.10testOptions.headless -Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. +Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. **Usage** diff --git a/nodejs/docs/release-notes.mdx b/nodejs/docs/release-notes.mdx index 9d9fe7e7d32..f4bee905bfb 100644 --- a/nodejs/docs/release-notes.mdx +++ b/nodejs/docs/release-notes.mdx @@ -64,7 +64,7 @@ This is not just useful for capturing varying ports of dev servers. You can also ### Breaking Change -After 3 years of being deprecated, we removed `Page#accessibility` from our API. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe. +After 3 years of being deprecated, we removed `page.accessibility` from our API. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe. ### New APIs - New property [testConfig.tag](/api/class-testconfig.mdx#test-config-tag) adds a tag to all tests in this run. This is useful when using [merge-reports](./test-sharding.mdx#merging-reports-from-multiple-shards). @@ -76,7 +76,7 @@ After 3 years of being deprecated, we removed `Page#accessibility` from our API. ### Browser Versions - Chromium 143.0.7499.4 -- Mozilla Firefox 142.0.1 +- Mozilla Firefox 144.0.2 - WebKit 26.0 ## Version 1.56 diff --git a/python/docs/api/class-browsertype.mdx b/python/docs/api/class-browsertype.mdx index bf6bc4810dc..60287b0f5cf 100644 --- a/python/docs/api/class-browsertype.mdx +++ b/python/docs/api/class-browsertype.mdx @@ -242,14 +242,6 @@ browser = await playwright.chromium.launch( # or "firefox" or "webkit". - `chromium_sandbox` [bool] *(optional)*# Enable Chromium sandboxing. Defaults to `false`. -- `devtools` [bool] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [headless](/api/class-browsertype.mdx#browser-type-launch-option-headless) option will be set `false`. - `downloads_path` [Union]\[[str], [pathlib.Path]\] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -275,7 +267,7 @@ browser = await playwright.chromium.launch( # or "firefox" or "webkit". Close the browser process on SIGTERM. Defaults to `true`. - `headless` [bool] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `ignore_default_args` [bool] | [List]\[[str]\] *(optional)*# If `true`, Playwright does not pass its own configurations args and only uses the ones from [args](/api/class-browsertype.mdx#browser-type-launch-option-args). If an array is given, then filters out the given default arguments. Dangerous option; use with care. Defaults to `false`. @@ -416,14 +408,6 @@ browser_type.launch_persistent_context(user_data_dir, **kwargs) - `device_scale_factor` [float] *(optional)*# Specify device scale factor (can be thought of as dpr). Defaults to `1`. Learn more about [emulating devices with device scale factor](../emulation.mdx#devices). -- `devtools` [bool] *(optional)*# - - :::warning[Deprecated] - Use [debugging tools](../debug.mdx) instead. - ::: - - - **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the [headless](/api/class-browsertype.mdx#browser-type-launch-persistent-context-option-headless) option will be set `false`. - `downloads_path` [Union]\[[str], [pathlib.Path]\] *(optional)*# If specified, accepted downloads are downloaded into this directory. Otherwise, temporary directory is created and is deleted when browser is closed. In either case, the downloads are deleted when the browser context they were created in is closed. @@ -468,7 +452,7 @@ browser_type.launch_persistent_context(user_data_dir, **kwargs) Specifies if viewport supports touch events. Defaults to false. Learn more about [mobile emulation](../emulation.mdx#devices). - `headless` [bool] *(optional)*# - Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the [devtools](/api/class-browsertype.mdx#browser-type-launch-option-devtools) option is `true`. + Whether to run browser in headless mode. More details for [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`. - `http_credentials` [Dict] *(optional)*# - `username` [str] diff --git a/python/docs/release-notes.mdx b/python/docs/release-notes.mdx index d58382dadce..befcf7d660f 100644 --- a/python/docs/release-notes.mdx +++ b/python/docs/release-notes.mdx @@ -7,6 +7,36 @@ import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import HTMLCard from '@site/src/components/HTMLCard'; +## Version 1.57 + +### Chrome for Testing + +Starting with this release, Playwright switches from Chromium, to using [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) builds. Both headed and headless browsers are subject to this. Your tests should still be passing after upgrading to Playwright 1.57. + +We're expecting no functional changes to come from this switch. The biggest change is the new icon and title in your toolbar. + +![new and old logo](../images/cft-logo-change.png) + +If you still see an unexpected behaviour change, please [file an issue](https://github.com/microsoft/playwright/issues/new). + +On Arm64 Linux, Playwright continues to use Chromium. + +### Breaking Change + +After 3 years of being deprecated, we removed `page.accessibility` from our API. Please use other libraries such as [Axe](https://www.deque.com/axe/) if you need to test page accessibility. See our Node.js [guide](https://playwright.dev/docs/accessibility-testing) for integration with Axe. + +### New APIs +- [worker.on("console")](/api/class-worker.mdx#worker-event-console) event is emitted when JavaScript within the worker calls one of console API methods, e.g. console.log or console.dir. [worker.expect_event()](/api/class-worker.mdx#worker-wait-for-event) can be used to wait for it. +- [locator.description](/api/class-locator.mdx#locator-description) returns locator description previously set with [locator.describe()](/api/class-locator.mdx#locator-describe). +- New option [steps](/api/class-locator.mdx#locator-click-option-steps) in [locator.click()](/api/class-locator.mdx#locator-click) and [locator.drag_to()](/api/class-locator.mdx#locator-drag-to) that configures the number of `mousemove` events emitted while moving the mouse pointer to the target element. +- Network requests issued by [Service Workers](./service-workers.md#network-events-and-routing) are now reported and can be routed through the [BrowserContext](./api/class-browsercontext.mdx), only in Chromium. You can opt out using the `PLAYWRIGHT_DISABLE_SERVICE_WORKER_NETWORK` environment variable. +- Console messages from Service Workers are dispatched through [worker.on("console")](/api/class-worker.mdx#worker-event-console). You can opt out of this using the `PLAYWRIGHT_DISABLE_SERVICE_WORKER_CONSOLE` environment variable. + +### Browser Versions +- Chromium 143.0.7499.4 +- Mozilla Firefox 144.0.2 +- WebKit 26.0 + ## Version 1.56 ### New APIs