Playwright is a framework for Web Testing and Automation. It allows testing Chromium, Firefox and WebKit with a single API.
TypeScript automationchromechromiume2e-testingelectronend-to-end-testingfirefoxjavascriptplaywrighttesttest-automationtestingtesting-toolswebwebkit
docs: 1.57 release notes (#38267)
Simon Knott483b7222563c
diff --git a/docs/src/images/cft-logo-change.png b/docs/src/images/cft-logo-change.pngnew file mode 100644index 0000000000..89c5695e29Binary files /dev/null and b/docs/src/images/cft-logo-change.png differdiff --git a/docs/src/images/speedboard.png b/docs/src/images/speedboard.pngnew file mode 100644index 0000000000..e6fa26ab61Binary files /dev/null and b/docs/src/images/speedboard.png differdiff --git a/docs/src/release-notes-js.md b/docs/src/release-notes-js.mdindex 7c05fe4719..5a2a533f45 100644--- a/docs/src/release-notes-js.md+++ b/docs/src/release-notes-js.md@@ -6,6 +6,83 @@ toc_max_heading_level: 2import LiteYouTube from '@site/src/components/LiteYouTube';+## Version 1.57++### Speedboard++In HTML reporter, there's a new tab we call "Speedboard":++++It shows you all your executed tests sorted by slowness,+and can help you understand where your test suite is taking longer than expected.+Take a look at yours - maybe you'll find some tests that are spending a longer time waiting than they should!++### 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:++++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.++### Waiting for webserver output++[`property: TestConfig.webServer`] added a `wait` field. Pass a regular expression, and Playwright will wait until the webserver logs match it.++```js+import { defineConfig } from '@playwright/test';++export default defineConfig({+ webServer: {+ command: 'npm run start',+ wait: {+ stdout: '/Listening on port (?<my_server_port>\\d+)/'+ },+ },+});+```++If you include a named capture group into the expression, then Playwright will provide the capture group contents via environment variables:++```js+import { test, expect } from '@playwright/test';++test.use({ baseUrl: `http://localhost:${process.env.MY_SERVER_PORT ?? 3000}` });++test('homepage', async ({ page }) => {+ await page.goto('/');+});+```++This is not just useful for capturing varying ports of dev servers:+You can also use it to wait for readiness of a service that doesn't expose an HTTP readiness check, but instead prints a readiness message to stdout or stderr.++### 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++- New property [`property: TestConfig.tag`] adds a tag to all tests in this run. This is useful when using [merge-reports](./test-sharding.md#merging-reports-from-multiple-shards).+- [`event: Worker.console`] event is emitted when JavaScript within the worker calls one of console API methods, e.g. console.log or console.dir. [`method: Worker.waitForEvent`] can be used to wait for it. You can opt out of this using the `PLAYWRIGHT_DISABLE_SERVICE_WORKER_CONSOLE` environment variable.+- [`method: Locator.description`] returns locator description previously set with [`method: Locator.describe`], and `Locator.toString()` now uses the description when available.+- New option [`option: Locator.click.steps`] in [`method: Locator.click`] and [`method: Locator.dragTo`] 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.md), only in Chromium. You can opt out using the `PLAYWRIGHT_DISABLE_SERVICE_WORKER_NETWORK` environment variable.+- New methods [`method: Request.postData`], [`method: Request.postDataBuffer`] and [`method: Request.postDataJSON`].+- Option [`property: TestConfig.webServer`] added a `wait` field to check readiness based on stdout/stderr.++### Browser Versions++- Chromium 143.0.7499.4+- Mozilla Firefox 142.0.1+- WebKit 26.0+## Version 1.56<LiteYouTubediff --git a/docs/src/test-api/class-testconfig.md b/docs/src/test-api/class-testconfig.mdindex 0c83d42c07..d8247126c7 100644--- a/docs/src/test-api/class-testconfig.md+++ b/docs/src/test-api/class-testconfig.md@@ -779,6 +779,31 @@ export default defineConfig({});```+If your webserver runs on varying ports, use `wait` to capture the port:++```js+import { defineConfig } from '@playwright/test';++export default defineConfig({+ webServer: {+ command: 'npm run start',+ wait: {+ stdout: '/Listening on port (?<my_server_port>\\d+)/'+ },+ },+});+```++```js+import { test, expect } from '@playwright/test';++test.use({ baseUrl: `http://localhost:${process.env.MY_SERVER_PORT ?? 3000}` });++test('homepage', async ({ page }) => {+ await page.goto('/');+});+```+## property: TestConfig.workers* since: v1.10- type: ?<[int]|[string]>diff --git a/packages/playwright/types/test.d.ts b/packages/playwright/types/test.d.tsindex 630d8ce04d..3a9817f1fa 100644--- a/packages/playwright/types/test.d.ts+++ b/packages/playwright/types/test.d.ts@@ -992,6 +992,31 @@ interface TestConfig<TestArgs = {}, WorkerArgs = {}> {* });* ```*+ * If your webserver runs on varying ports, use `wait` to capture the port:+ *+ * ```js+ * import { defineConfig } from '@playwright/test';+ *+ * export default defineConfig({+ * webServer: {+ * command: 'npm run start',+ * wait: {+ * stdout: '/Listening on port (?<my_server_port>\\d+)/'+ * },+ * },+ * });+ * ```+ *+ * ```js+ * import { test, expect } from '@playwright/test';+ *+ * test.use({ baseUrl: `http://localhost:${process.env.MY_SERVER_PORT ?? 3000}` });+ *+ * test('homepage', async ({ page }) => {+ * await page.goto('/');+ * });+ * ```+ **/webServer?: TestConfigWebServer | TestConfigWebServer[];/**