From d13df4b8e266436241466c23878e229bd844a039 Mon Sep 17 00:00:00 2001 From: "microsoft-playwright-automation[bot]" <203992400+microsoft-playwright-automation[bot]@users.noreply.github.com> Date: Tue, 3 Feb 2026 10:21:18 +0000 Subject: [PATCH] feat(roll): roll to ToT Playwright (03-02-26) --- dotnet/docs/api/class-browsercontext.mdx | 2 +- dotnet/docs/api/class-frame.mdx | 6 +++--- dotnet/docs/api/class-page.mdx | 8 ++++---- dotnet/docs/api/class-request.mdx | 19 +++++++++++++++++++ dotnet/docs/api/class-video.mdx | 2 +- dotnet/docs/ci.mdx | 10 +++++----- dotnet/docs/docker.mdx | 16 ++++++++-------- java/docs/api/class-browsercontext.mdx | 2 +- java/docs/api/class-frame.mdx | 4 ++-- java/docs/api/class-page.mdx | 6 +++--- java/docs/api/class-request.mdx | 19 +++++++++++++++++++ java/docs/api/class-video.mdx | 2 +- nodejs/docs/api/class-browsercontext.mdx | 8 ++++---- nodejs/docs/api/class-frame.mdx | 8 ++++---- nodejs/docs/api/class-page.mdx | 22 +++++++++++----------- nodejs/docs/api/class-pageassertions.mdx | 5 ++++- nodejs/docs/api/class-request.mdx | 19 +++++++++++++++++++ nodejs/docs/api/class-video.mdx | 2 +- nodejs/docs/ci.mdx | 20 ++++++++++---------- nodejs/docs/debug.mdx | 2 +- nodejs/docs/docker.mdx | 18 +++++++++--------- python/docs/api/class-browsercontext.mdx | 2 +- python/docs/api/class-frame.mdx | 4 ++-- python/docs/api/class-page.mdx | 6 +++--- python/docs/api/class-request.mdx | 19 +++++++++++++++++++ python/docs/api/class-video.mdx | 2 +- python/docs/ci.mdx | 12 ++++++------ python/docs/docker.mdx | 18 +++++++++--------- src/components/GitHubStarButton/index.tsx | 2 +- 29 files changed, 172 insertions(+), 93 deletions(-) diff --git a/dotnet/docs/api/class-browsercontext.mdx b/dotnet/docs/api/class-browsercontext.mdx index 88c258e2ca1..dff2b25a056 100644 --- a/dotnet/docs/api/class-browsercontext.mdx +++ b/dotnet/docs/api/class-browsercontext.mdx @@ -954,7 +954,7 @@ await BrowserContext.UnrouteAsync(url, handler); **Arguments** - `url` [string] | [Regex] | [Func]<[string], bool># - A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [BrowserContext.RouteAsync()](/api/class-browsercontext.mdx#browser-context-route). + A glob pattern, regex pattern, or predicate receiving [URL] used to register a routing with [BrowserContext.RouteAsync()](/api/class-browsercontext.mdx#browser-context-route). - `handler` [Action]<[Route]?> *(optional)*# Optional handler function used to register a routing with [BrowserContext.RouteAsync()](/api/class-browsercontext.mdx#browser-context-route). diff --git a/dotnet/docs/api/class-frame.mdx b/dotnet/docs/api/class-frame.mdx index bc77f685fe8..f1875816c4f 100644 --- a/dotnet/docs/api/class-frame.mdx +++ b/dotnet/docs/api/class-frame.mdx @@ -1049,7 +1049,7 @@ await frame.WaitForURLAsync("**/target.html"); **Arguments** - `url` [string] | [Regex] | [Func]<[string], bool># - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` `FrameWaitForURLOptions?` *(optional)* - `Timeout` [float]? *(optional)*# @@ -2107,7 +2107,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.SetDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.SetDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.SetDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.SetDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `Url|UrlRegex|UrlFunc` [string]? | [Regex]? | [Func]<[string]?, bool> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `WaitUntil` `enum WaitUntilState { Load, DOMContentLoaded, NetworkIdle, Commit }?` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: @@ -2159,7 +2159,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.SetDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.SetDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.SetDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.SetDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `Url|UrlRegex|UrlFunc` [string]? | [Regex]? | [Func]<[string]?, bool> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `WaitUntil` `enum WaitUntilState { Load, DOMContentLoaded, NetworkIdle, Commit }?` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/dotnet/docs/api/class-page.mdx b/dotnet/docs/api/class-page.mdx index 14d7a343fe4..47133aaf4f7 100644 --- a/dotnet/docs/api/class-page.mdx +++ b/dotnet/docs/api/class-page.mdx @@ -2535,7 +2535,7 @@ await Page.UnrouteAsync(url, handler); **Arguments** - `url` [string] | [Regex] | [Func]<[string], bool># - A glob pattern, regex pattern or predicate receiving [URL] to match while routing. + A glob pattern, regex pattern, or predicate receiving [URL] to match while routing. - `handler` [Action]<[Route]?> *(optional)*# Optional handler function to route the request. @@ -2741,7 +2741,7 @@ await page.WaitForURLAsync("**/target.html"); **Arguments** - `url` [string] | [Regex] | [Func]<[string], bool># - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` `PageWaitForURLOptions?` *(optional)* - `Timeout` [float]? *(optional)*# @@ -4315,7 +4315,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.SetDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.SetDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.SetDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.SetDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `Url|UrlRegex|UrlFunc` [string]? | [Regex]? | [Func]<[string]?, bool> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `WaitUntil` `enum WaitUntilState { Load, DOMContentLoaded, NetworkIdle, Commit }?` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: @@ -4367,7 +4367,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.SetDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.SetDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.SetDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.SetDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `Url|UrlRegex|UrlFunc` [string]? | [Regex]? | [Func]<[string]?, bool> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `WaitUntil` `enum WaitUntilState { Load, DOMContentLoaded, NetworkIdle, Commit }?` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/dotnet/docs/api/class-request.mdx b/dotnet/docs/api/class-request.mdx index edb81d78dfe..85cb3ea9153 100644 --- a/dotnet/docs/api/class-request.mdx +++ b/dotnet/docs/api/class-request.mdx @@ -43,6 +43,25 @@ await Request.AllHeadersAsync(); --- +### ExistingResponse {#request-existing-response} + +Added in: v1.59request.ExistingResponse + +Returns the [Response] object if the response has already been received, `null` otherwise. + +Unlike [Request.ResponseAsync()](/api/class-request.mdx#request-response), this method does not wait for the response to arrive. It returns immediately with the response object if the response has been received, or `null` if the response has not been received yet. + +**Usage** + +```csharp +Request.ExistingResponse +``` + +**Returns** +- [Response]?# + +--- + ### Failure {#request-failure} Added before v1.9request.Failure diff --git a/dotnet/docs/api/class-video.mdx b/dotnet/docs/api/class-video.mdx index 5906070ec76..d2bf16aeb17 100644 --- a/dotnet/docs/api/class-video.mdx +++ b/dotnet/docs/api/class-video.mdx @@ -117,7 +117,7 @@ await page.Video.StopAsync(new() { Path = "video.webm" }); Added in: v1.59video.StopAsync -Stops video recording started with [Video.StartAsync()](/api/class-video.mdx#video-start) and either saves or discards the video file. +Stops video recording started with [Video.StartAsync()](/api/class-video.mdx#video-start). **Usage** diff --git a/dotnet/docs/ci.mdx b/dotnet/docs/ci.mdx index cf201dd8bed..15691a01160 100644 --- a/dotnet/docs/ci.mdx +++ b/dotnet/docs/ci.mdx @@ -76,7 +76,7 @@ jobs: name: 'Playwright Tests' runs-on: ubuntu-latest container: - image: mcr.microsoft.com/playwright/dotnet:v1.57.0-noble + image: mcr.microsoft.com/playwright/dotnet:v1.58.0-noble options: --user 1001 steps: - uses: actions/checkout@v5 @@ -159,7 +159,7 @@ trigger: pool: vmImage: ubuntu-latest -container: mcr.microsoft.com/playwright/dotnet:v1.57.0-noble +container: mcr.microsoft.com/playwright/dotnet:v1.58.0-noble steps: - task: UseDotNet@2 @@ -182,7 +182,7 @@ Running Playwright on CircleCI is very similar to running on GitHub Actions. In executors: pw-noble-development: docker: - - image: mcr.microsoft.com/playwright/dotnet:v1.57.0-noble + - image: mcr.microsoft.com/playwright/dotnet:v1.58.0-noble ``` Note: When using the docker agent definition, you are specifying the resource class of where playwright runs to the 'medium' tier [here](https://circleci.com/docs/configuration-reference?#docker-execution-environment). The default behavior of Playwright is to set the number of workers to the detected core count (2 in the case of the medium tier). Overriding the number of workers to greater than this number will cause unnecessary timeouts and failures. @@ -193,7 +193,7 @@ Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image]( ```groovy pipeline { - agent { docker { image 'mcr.microsoft.com/playwright/dotnet:v1.57.0-noble' } } + agent { docker { image 'mcr.microsoft.com/playwright/dotnet:v1.58.0-noble' } } stages { stage('e2e-tests') { steps { @@ -210,7 +210,7 @@ pipeline { Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.mdx)). ```yml -image: mcr.microsoft.com/playwright/dotnet:v1.57.0-noble +image: mcr.microsoft.com/playwright/dotnet:v1.58.0-noble ``` ### GitLab CI diff --git a/dotnet/docs/docker.mdx b/dotnet/docs/docker.mdx index 02f19899527..e94a5ef36da 100644 --- a/dotnet/docs/docker.mdx +++ b/dotnet/docs/docker.mdx @@ -22,7 +22,7 @@ This Docker image is intended to be used for testing and development purposes on ### Pull the image ```bash -docker pull mcr.microsoft.com/playwright/dotnet:v1.57.0-noble +docker pull mcr.microsoft.com/playwright/dotnet:v1.58.0-noble ``` ### Run the image @@ -34,7 +34,7 @@ By default, the Docker image will use the `root` user to run the browsers. This On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers. ```bash -docker run -it --rm --ipc=host mcr.microsoft.com/playwright/dotnet:v1.57.0-noble /bin/bash +docker run -it --rm --ipc=host mcr.microsoft.com/playwright/dotnet:v1.58.0-noble /bin/bash ``` #### Crawling and scraping @@ -42,7 +42,7 @@ docker run -it --rm --ipc=host mcr.microsoft.com/playwright/dotnet:v1.57.0-noble On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it. ```bash -docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/dotnet:v1.57.0-noble /bin/bash +docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/dotnet:v1.58.0-noble /bin/bash ``` [`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/main/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions: @@ -82,7 +82,7 @@ You can run Playwright Server in Docker while keeping your tests running on the Start the Playwright Server in Docker: ```bash -docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.57.0-noble /bin/sh -c "npx -y playwright@1.57.0 run-server --port 3000 --host 0.0.0.0" +docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" ``` #### Connecting to the Server @@ -99,7 +99,7 @@ await using var browser = await playwright.Chromium.ConnectAsync("ws://127.0.0.1 If you need to access local servers from within the Docker container: ```bash -docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.57.0-noble /bin/sh -c "npx -y playwright@1.57.0 run-server --port 3000 --host 0.0.0.0" +docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" ``` This makes `hostmachine` point to the host's localhost. Your tests should use `hostmachine` instead of `localhost` when accessing local servers. @@ -132,9 +132,9 @@ Once this is enabled you can open the port specified in a new browser tab and yo See [all available image tags]. We currently publish images with the following tags: -- `:v1.57.0` - Playwright v1.57.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.57.0-noble` - Playwright v1.57.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.57.0-jammy` - Playwright v1.57.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). +- `:v1.58.0` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.0-noble` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.0-jammy` - Playwright v1.58.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). :::note diff --git a/java/docs/api/class-browsercontext.mdx b/java/docs/api/class-browsercontext.mdx index a6d804b0099..c19668b3851 100644 --- a/java/docs/api/class-browsercontext.mdx +++ b/java/docs/api/class-browsercontext.mdx @@ -853,7 +853,7 @@ BrowserContext.unroute(url, handler); **Arguments** - `url` [String] | [Pattern] | [Predicate]<[String]># - A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [BrowserContext.route()](/api/class-browsercontext.mdx#browser-context-route). + A glob pattern, regex pattern, or predicate receiving [URL] used to register a routing with [BrowserContext.route()](/api/class-browsercontext.mdx#browser-context-route). - `handler` [Consumer]<[Route]> *(optional)*# Optional handler function used to register a routing with [BrowserContext.route()](/api/class-browsercontext.mdx#browser-context-route). diff --git a/java/docs/api/class-frame.mdx b/java/docs/api/class-frame.mdx index 21df4c2b509..b5c7124df7e 100644 --- a/java/docs/api/class-frame.mdx +++ b/java/docs/api/class-frame.mdx @@ -1053,7 +1053,7 @@ frame.waitForURL("**/target.html"); **Arguments** - `url` [String] | [Pattern] | [Predicate]<[String]># - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` `Frame.WaitForURLOptions` *(optional)* - `setTimeout` [double] *(optional)*# @@ -2548,7 +2548,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.setDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.setDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `setUrl` [String] | [Pattern] | [Predicate]<[String]> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `setWaitUntil` `enum WaitUntilState { LOAD, DOMCONTENTLOADED, NETWORKIDLE, COMMIT }` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/java/docs/api/class-page.mdx b/java/docs/api/class-page.mdx index fac456d4403..b8ef96d794b 100644 --- a/java/docs/api/class-page.mdx +++ b/java/docs/api/class-page.mdx @@ -2062,7 +2062,7 @@ Page.unroute(url, handler); **Arguments** - `url` [String] | [Pattern] | [Predicate]<[String]># - A glob pattern, regex pattern or predicate receiving [URL] to match while routing. + A glob pattern, regex pattern, or predicate receiving [URL] to match while routing. - `handler` [Consumer]<[Route]> *(optional)*# Optional handler function to route the request. @@ -2544,7 +2544,7 @@ page.waitForURL("**/target.html"); **Arguments** - `url` [String] | [Pattern] | [Predicate]<[String]># - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` `Page.WaitForURLOptions` *(optional)* - `setTimeout` [double] *(optional)*# @@ -4618,7 +4618,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [BrowserContext.setDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [BrowserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [Page.setDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [Page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `setUrl` [String] | [Pattern] | [Predicate]<[String]> *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `setWaitUntil` `enum WaitUntilState { LOAD, DOMCONTENTLOADED, NETWORKIDLE, COMMIT }` *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/java/docs/api/class-request.mdx b/java/docs/api/class-request.mdx index 11d2f87c357..03e8e65fd49 100644 --- a/java/docs/api/class-request.mdx +++ b/java/docs/api/class-request.mdx @@ -43,6 +43,25 @@ Request.allHeaders(); --- +### existingResponse {#request-existing-response} + +Added in: v1.59request.existingResponse + +Returns the [Response] object if the response has already been received, `null` otherwise. + +Unlike [Request.response()](/api/class-request.mdx#request-response), this method does not wait for the response to arrive. It returns immediately with the response object if the response has been received, or `null` if the response has not been received yet. + +**Usage** + +```java +Request.existingResponse(); +``` + +**Returns** +- [null] | [Response]# + +--- + ### failure {#request-failure} Added before v1.9request.failure diff --git a/java/docs/api/class-video.mdx b/java/docs/api/class-video.mdx index 521916f8109..2febf2a5e5e 100644 --- a/java/docs/api/class-video.mdx +++ b/java/docs/api/class-video.mdx @@ -117,7 +117,7 @@ page.video().stop(new Video.StopOptions().setPath(Paths.get("video.webm"))); Added in: v1.59video.stop -Stops video recording started with [Video.start()](/api/class-video.mdx#video-start) and either saves or discards the video file. +Stops video recording started with [Video.start()](/api/class-video.mdx#video-start). **Usage** diff --git a/nodejs/docs/api/class-browsercontext.mdx b/nodejs/docs/api/class-browsercontext.mdx index 8bdef2b174c..b3384ca7a7a 100644 --- a/nodejs/docs/api/class-browsercontext.mdx +++ b/nodejs/docs/api/class-browsercontext.mdx @@ -578,9 +578,9 @@ Enabling routing disables http cache. ::: **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) is set in the context options and the provided URL is a string that does not start with `*`, it is resolved using the [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor. + A glob pattern, regex pattern, URL pattern, or predicate that receives a [URL] to match during routing. If [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) is set in the context options and the provided URL is a string that does not start with `*`, it is resolved using the [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor. - `handler` [function]\([Route], [Request]\):[Promise]<[Object]> | [Object]# handler function to route the request. @@ -973,9 +973,9 @@ await browserContext.unroute(url, handler); ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [browserContext.route()](/api/class-browsercontext.mdx#browser-context-route). + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] used to register a routing with [browserContext.route()](/api/class-browsercontext.mdx#browser-context-route). - `handler` [function]\([Route], [Request]\):[Promise]<[Object]> | [Object] *(optional)*# Optional handler function used to register a routing with [browserContext.route()](/api/class-browsercontext.mdx#browser-context-route). diff --git a/nodejs/docs/api/class-frame.mdx b/nodejs/docs/api/class-frame.mdx index adc5ca5c43d..fb9a04d8105 100644 --- a/nodejs/docs/api/class-frame.mdx +++ b/nodejs/docs/api/class-frame.mdx @@ -1051,9 +1051,9 @@ await frame.waitForURL('**/target.html'); ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` [Object] *(optional)* - `timeout` [number] *(optional)*# @@ -2545,9 +2545,9 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist - `timeout` [number] *(optional)*# Maximum operation time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `navigationTimeout` option in the config, or by using the [browserContext.setDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.setDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - - `url` [string] | [RegExp] | [function]\([URL]\):[boolean] *(optional)*# + - `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean] *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `waitUntil` "load" | "domcontentloaded" | "networkidle" | "commit" *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/nodejs/docs/api/class-page.mdx b/nodejs/docs/api/class-page.mdx index 1c221252617..007be540f29 100644 --- a/nodejs/docs/api/class-page.mdx +++ b/nodejs/docs/api/class-page.mdx @@ -788,9 +788,9 @@ const frame = page.frame({ url: /.*domain.*/ }); - `name` [string] *(optional)* Frame name specified in the `iframe`'s `name` attribute. Optional. - - `url` [string] | [RegExp] | [function]\([URL]\):[boolean] *(optional)* + - `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean] *(optional)* - A glob pattern, regex pattern or predicate receiving frame's `url` as a [URL] object. Optional. + A glob pattern, regex pattern, URL pattern, or predicate receiving frame's `url` as a [URL] object. Optional. Frame name or other frame lookup options. @@ -1749,9 +1749,9 @@ Enabling routing disables http cache. ::: **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern, or predicate that receives a [URL] to match during routing. If [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) is set in the context options and the provided URL is a string that does not start with `*`, it is resolved using the [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor. + A glob pattern, regex pattern, URL pattern, or predicate that receives a [URL] to match during routing. If [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) is set in the context options and the provided URL is a string that does not start with `*`, it is resolved using the [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor. - `handler` [function]\([Route], [Request]\):[Promise]<[Object]> | [Object]# handler function to route the request. @@ -1830,7 +1830,7 @@ await page.routeWebSocket('/ws', ws => { ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# Only WebSockets with the url matching this pattern will be routed. A string pattern can be relative to the [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) context option. - `handler` [function]\([WebSocketRoute]\):[Promise]<[Object]> | [Object]# @@ -2100,9 +2100,9 @@ await page.unroute(url, handler); ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern or predicate receiving [URL] to match while routing. + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] to match while routing. - `handler` [function]\([Route], [Request]\):[Promise]<[Object]> | [Object] *(optional)*# Optional handler function to route the request. @@ -2412,9 +2412,9 @@ await page.waitForURL('**/target.html'); ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean]# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean]# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `options` [Object] *(optional)* - `timeout` [number] *(optional)*# @@ -4452,9 +4452,9 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist - `timeout` [number] *(optional)*# Maximum operation time in milliseconds. Defaults to `0` - no timeout. The default value can be changed via `navigationTimeout` option in the config, or by using the [browserContext.setDefaultNavigationTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browserContext.setDefaultTimeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.setDefaultNavigationTimeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.setDefaultTimeout()](/api/class-page.mdx#page-set-default-timeout) methods. - - `url` [string] | [RegExp] | [function]\([URL]\):[boolean] *(optional)*# + - `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean] *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, URL pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `waitUntil` "load" | "domcontentloaded" | "networkidle" | "commit" *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/nodejs/docs/api/class-pageassertions.mdx b/nodejs/docs/api/class-pageassertions.mdx index 74e053becc4..5e936e8235e 100644 --- a/nodejs/docs/api/class-pageassertions.mdx +++ b/nodejs/docs/api/class-pageassertions.mdx @@ -226,6 +226,9 @@ await expect(page).toHaveURL('https://playwright.dev/docs/intro'); // Check for the page URL to contain 'doc', followed by an optional 's', followed by '/' await expect(page).toHaveURL(/docs?\//); +// Check for the page URL to match the URL pattern +await expect(page).toHaveURL(new URLPattern({ pathname: '/docs/*' })); + // Check for the predicate to be satisfied // For example: verify query strings await expect(page).toHaveURL(url => { @@ -235,7 +238,7 @@ await expect(page).toHaveURL(url => { ``` **Arguments** -- `url` [string] | [RegExp] | [function]\([URL]\):[boolean] Added in: v1.18# +- `url` [string] | [RegExp] | [URLPattern] | [function]\([URL]\):[boolean] Added in: v1.18# Expected URL string, RegExp, or predicate receiving [URL] to match. When [baseURL](/api/class-browser.mdx#browser-new-context-option-base-url) is provided via the context options and the `url` argument is a string, the two values are merged via the [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor and used for the comparison against the current browser URL. - `options` [Object] *(optional)* diff --git a/nodejs/docs/api/class-request.mdx b/nodejs/docs/api/class-request.mdx index a44b77db288..c238e30c909 100644 --- a/nodejs/docs/api/class-request.mdx +++ b/nodejs/docs/api/class-request.mdx @@ -43,6 +43,25 @@ await request.allHeaders(); --- +### existingResponse {#request-existing-response} + +Added in: v1.59request.existingResponse + +Returns the [Response] object if the response has already been received, `null` otherwise. + +Unlike [request.response()](/api/class-request.mdx#request-response), this method does not wait for the response to arrive. It returns immediately with the response object if the response has been received, or `null` if the response has not been received yet. + +**Usage** + +```js +request.existingResponse(); +``` + +**Returns** +- [null] | [Response]# + +--- + ### failure {#request-failure} Added before v1.9request.failure diff --git a/nodejs/docs/api/class-video.mdx b/nodejs/docs/api/class-video.mdx index 783aa4fb3b4..ecade42bdfd 100644 --- a/nodejs/docs/api/class-video.mdx +++ b/nodejs/docs/api/class-video.mdx @@ -117,7 +117,7 @@ await page.video().stop({ path: 'video.webm' }); Added in: v1.59video.stop -Stops video recording started with [video.start()](/api/class-video.mdx#video-start) and either saves or discards the video file. +Stops video recording started with [video.start()](/api/class-video.mdx#video-start). **Usage** diff --git a/nodejs/docs/ci.mdx b/nodejs/docs/ci.mdx index c57d018a8c4..0a2f24df93d 100644 --- a/nodejs/docs/ci.mdx +++ b/nodejs/docs/ci.mdx @@ -101,7 +101,7 @@ jobs: name: 'Playwright Tests' runs-on: ubuntu-latest container: - image: mcr.microsoft.com/playwright:v1.58.0-noble + image: mcr.microsoft.com/playwright:v1.58.1-noble options: --user 1001 steps: - uses: actions/checkout@v5 @@ -335,7 +335,7 @@ trigger: pool: vmImage: ubuntu-latest -container: mcr.microsoft.com/playwright:v1.58.0-noble +container: mcr.microsoft.com/playwright:v1.58.1-noble steps: - task: UseNode@1 @@ -359,7 +359,7 @@ Running Playwright on CircleCI is very similar to running on GitHub Actions. In executors: pw-noble-development: docker: - - image: mcr.microsoft.com/playwright:v1.58.0-noble + - image: mcr.microsoft.com/playwright:v1.58.1-noble ``` Note: When using the docker agent definition, you are specifying the resource class of where playwright runs to the 'medium' tier [here](https://circleci.com/docs/configuration-reference?#docker-execution-environment). The default behavior of Playwright is to set the number of workers to the detected core count (2 in the case of the medium tier). Overriding the number of workers to greater than this number will cause unnecessary timeouts and failures. @@ -382,7 +382,7 @@ Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image]( ```groovy pipeline { - agent { docker { image 'mcr.microsoft.com/playwright:v1.58.0-noble' } } + agent { docker { image 'mcr.microsoft.com/playwright:v1.58.1-noble' } } stages { stage('e2e-tests') { steps { @@ -399,7 +399,7 @@ pipeline { Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.mdx)). ```yml -image: mcr.microsoft.com/playwright:v1.58.0-noble +image: mcr.microsoft.com/playwright:v1.58.1-noble ``` ### GitLab CI @@ -412,7 +412,7 @@ stages: tests: stage: test - image: mcr.microsoft.com/playwright:v1.58.0-noble + image: mcr.microsoft.com/playwright:v1.58.1-noble script: ... ``` @@ -427,7 +427,7 @@ stages: tests: stage: test - image: mcr.microsoft.com/playwright:v1.58.0-noble + image: mcr.microsoft.com/playwright:v1.58.1-noble parallel: 7 script: - npm ci @@ -442,7 +442,7 @@ stages: tests: stage: test - image: mcr.microsoft.com/playwright:v1.58.0-noble + image: mcr.microsoft.com/playwright:v1.58.1-noble parallel: matrix: - PROJECT: ['chromium', 'webkit'] @@ -458,7 +458,7 @@ To run Playwright tests on Google Cloud Build, use our public Docker image ([see ```yml steps: -- name: mcr.microsoft.com/playwright:v1.58.0-noble +- name: mcr.microsoft.com/playwright:v1.58.1-noble script: ... env: @@ -476,7 +476,7 @@ type: docker steps: - name: test - image: mcr.microsoft.com/playwright:v1.58.0-noble + image: mcr.microsoft.com/playwright:v1.58.1-noble commands: - npx playwright test ``` diff --git a/nodejs/docs/debug.mdx b/nodejs/docs/debug.mdx index 3bc8504bab1..891601de094 100644 --- a/nodejs/docs/debug.mdx +++ b/nodejs/docs/debug.mdx @@ -30,7 +30,7 @@ You can also edit the locators in VS Code and Playwright will show you the chang ### Picking a Locator -Pick a [locator](./locators.mdx) and copy it into your test file by clicking the **Pick locator** button form the testing sidebar. Then in the browser click the element you require and it will now show up in the **Pick locator** box in VS Code. Press 'enter' on your keyboard to copy the locator into the clipboard and then paste anywhere in your code. Or press 'escape' if you want to cancel. +Pick a [locator](./locators.mdx) and copy it into your test file by clicking the **Pick locator** button from the testing sidebar. Then in the browser click the element you require and it will now show up in the **Pick locator** box in VS Code. Press 'enter' on your keyboard to copy the locator into the clipboard and then paste anywhere in your code. Or press 'escape' if you want to cancel. Pick locators diff --git a/nodejs/docs/docker.mdx b/nodejs/docs/docker.mdx index 25735df6ef1..21361d61592 100644 --- a/nodejs/docs/docker.mdx +++ b/nodejs/docs/docker.mdx @@ -22,7 +22,7 @@ This Docker image is intended to be used for testing and development purposes on ### Pull the image ```bash -docker pull mcr.microsoft.com/playwright:v1.58.0-noble +docker pull mcr.microsoft.com/playwright:v1.58.1-noble ``` ### Run the image @@ -34,7 +34,7 @@ By default, the Docker image will use the `root` user to run the browsers. This On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers. ```bash -docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.58.0-noble /bin/bash +docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.58.1-noble /bin/bash ``` #### Crawling and scraping @@ -42,7 +42,7 @@ docker run -it --rm --ipc=host mcr.microsoft.com/playwright:v1.58.0-noble /bin/b On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it. ```bash -docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:v1.58.0-noble /bin/bash +docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:v1.58.1-noble /bin/bash ``` [`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/main/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions: @@ -82,7 +82,7 @@ You can run Playwright Server in Docker while keeping your tests running on the Start the Playwright Server in Docker: ```bash -docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" +docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.1-noble /bin/sh -c "npx -y playwright@1.58.1 run-server --port 3000 --host 0.0.0.0" ``` #### Connecting to the Server @@ -105,7 +105,7 @@ const browser = await playwright['chromium'].connect('ws://127.0.0.1:3000/'); If you need to access local servers from within the Docker container: ```bash -docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" +docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.1-noble /bin/sh -c "npx -y playwright@1.58.1 run-server --port 3000 --host 0.0.0.0" ``` This makes `hostmachine` point to the host's localhost. Your tests should use `hostmachine` instead of `localhost` when accessing local servers. @@ -138,9 +138,9 @@ Once this is enabled you can open the port specified in a new browser tab and yo See [all available image tags]. We currently publish images with the following tags: -- `:v1.58.0` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.58.0-noble` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.58.0-jammy` - Playwright v1.58.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). +- `:v1.58.1` - Playwright v1.58.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.1-noble` - Playwright v1.58.1 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.1-jammy` - Playwright v1.58.1 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). :::note @@ -164,7 +164,7 @@ To run Playwright inside Docker, you need to have Node.js, [Playwright browsers] ```Dockerfile FROM node:20-bookworm -RUN npx -y playwright@1.58.0 install --with-deps +RUN npx -y playwright@1.58.1 install --with-deps ``` diff --git a/python/docs/api/class-browsercontext.mdx b/python/docs/api/class-browsercontext.mdx index 3466e9bae9c..c627f1a361d 100644 --- a/python/docs/api/class-browsercontext.mdx +++ b/python/docs/api/class-browsercontext.mdx @@ -1346,7 +1346,7 @@ browser_context.unroute(url, **kwargs) **Arguments** - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool]# - A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [browser_context.route()](/api/class-browsercontext.mdx#browser-context-route). + A glob pattern, regex pattern, or predicate receiving [URL] used to register a routing with [browser_context.route()](/api/class-browsercontext.mdx#browser-context-route). - `handler` [Callable]\[[Route], [Request]\]:[Promise]\[[Any]\] | [Any] *(optional)*# Optional handler function used to register a routing with [browser_context.route()](/api/class-browsercontext.mdx#browser-context-route). diff --git a/python/docs/api/class-frame.mdx b/python/docs/api/class-frame.mdx index d35cd35dd80..158cf2c58d4 100644 --- a/python/docs/api/class-frame.mdx +++ b/python/docs/api/class-frame.mdx @@ -1384,7 +1384,7 @@ await frame.wait_for_url("**/target.html") **Arguments** - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool]# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `timeout` [float] *(optional)*# Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browser_context.set_default_navigation_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browser_context.set_default_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.set_default_navigation_timeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.set_default_timeout()](/api/class-page.mdx#page-set-default-timeout) methods. @@ -2019,7 +2019,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browser_context.set_default_navigation_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browser_context.set_default_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.set_default_navigation_timeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.set_default_timeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool] *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `wait_until` "load" | "domcontentloaded" | "networkidle" | "commit" *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/python/docs/api/class-page.mdx b/python/docs/api/class-page.mdx index 2e97b9d9b7f..4a0614f50cf 100644 --- a/python/docs/api/class-page.mdx +++ b/python/docs/api/class-page.mdx @@ -3057,7 +3057,7 @@ page.unroute(url, **kwargs) **Arguments** - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool]# - A glob pattern, regex pattern or predicate receiving [URL] to match while routing. + A glob pattern, regex pattern, or predicate receiving [URL] to match while routing. - `handler` [Callable]\[[Route], [Request]\]:[Promise]\[[Any]\] | [Any] *(optional)*# Optional handler function to route the request. @@ -3361,7 +3361,7 @@ await page.wait_for_url("**/target.html") **Arguments** - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool]# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `timeout` [float] *(optional)*# Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browser_context.set_default_navigation_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browser_context.set_default_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.set_default_navigation_timeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.set_default_timeout()](/api/class-page.mdx#page-set-default-timeout) methods. @@ -4593,7 +4593,7 @@ Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/Hist Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browser_context.set_default_navigation_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-navigation-timeout), [browser_context.set_default_timeout()](/api/class-browsercontext.mdx#browser-context-set-default-timeout), [page.set_default_navigation_timeout()](/api/class-page.mdx#page-set-default-navigation-timeout) or [page.set_default_timeout()](/api/class-page.mdx#page-set-default-timeout) methods. - `url` [str] | [Pattern] | [Callable]\[[URL]\]:[bool] *(optional)*# - A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. + A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly equal to the string. - `wait_until` "load" | "domcontentloaded" | "networkidle" | "commit" *(optional)*# When to consider operation succeeded, defaults to `load`. Events can be either: diff --git a/python/docs/api/class-request.mdx b/python/docs/api/class-request.mdx index 5dcc69043a4..99b10dc859a 100644 --- a/python/docs/api/class-request.mdx +++ b/python/docs/api/class-request.mdx @@ -136,6 +136,25 @@ request.sizes() ## Properties +### existing_response {#request-existing-response} + +Added in: v1.59request.existing_response + +Returns the [Response] object if the response has already been received, `null` otherwise. + +Unlike [request.response()](/api/class-request.mdx#request-response), this method does not wait for the response to arrive. It returns immediately with the response object if the response has been received, or `null` if the response has not been received yet. + +**Usage** + +```python +request.existing_response +``` + +**Returns** +- [NoneType] | [Response]# + +--- + ### failure {#request-failure} Added before v1.9request.failure diff --git a/python/docs/api/class-video.mdx b/python/docs/api/class-video.mdx index 9d1e63e6566..0f22d0507e9 100644 --- a/python/docs/api/class-video.mdx +++ b/python/docs/api/class-video.mdx @@ -180,7 +180,7 @@ await page.video.stop(path="video.webm") Added in: v1.59video.stop -Stops video recording started with [video.start()](/api/class-video.mdx#video-start) and either saves or discards the video file. +Stops video recording started with [video.start()](/api/class-video.mdx#video-start). **Usage** diff --git a/python/docs/ci.mdx b/python/docs/ci.mdx index ef8ac086264..f957473e47b 100644 --- a/python/docs/ci.mdx +++ b/python/docs/ci.mdx @@ -83,7 +83,7 @@ jobs: name: 'Playwright Tests' runs-on: ubuntu-latest container: - image: mcr.microsoft.com/playwright/python:v1.57.0-noble + image: mcr.microsoft.com/playwright/python:v1.58.0-noble options: --user 1001 steps: - uses: actions/checkout@v5 @@ -173,7 +173,7 @@ trigger: pool: vmImage: ubuntu-latest -container: mcr.microsoft.com/playwright/python:v1.57.0-noble +container: mcr.microsoft.com/playwright/python:v1.58.0-noble steps: - task: UsePythonVersion@0 @@ -197,7 +197,7 @@ Running Playwright on CircleCI is very similar to running on GitHub Actions. In executors: pw-noble-development: docker: - - image: mcr.microsoft.com/playwright/python:v1.57.0-noble + - image: mcr.microsoft.com/playwright/python:v1.58.0-noble ``` Note: When using the docker agent definition, you are specifying the resource class of where playwright runs to the 'medium' tier [here](https://circleci.com/docs/configuration-reference?#docker-execution-environment). The default behavior of Playwright is to set the number of workers to the detected core count (2 in the case of the medium tier). Overriding the number of workers to greater than this number will cause unnecessary timeouts and failures. @@ -208,7 +208,7 @@ Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image]( ```groovy pipeline { - agent { docker { image 'mcr.microsoft.com/playwright/python:v1.57.0-noble' } } + agent { docker { image 'mcr.microsoft.com/playwright/python:v1.58.0-noble' } } stages { stage('e2e-tests') { steps { @@ -225,7 +225,7 @@ pipeline { Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.mdx)). ```yml -image: mcr.microsoft.com/playwright/python:v1.57.0-noble +image: mcr.microsoft.com/playwright/python:v1.58.0-noble ``` ### GitLab CI @@ -238,7 +238,7 @@ stages: tests: stage: test - image: mcr.microsoft.com/playwright/python:v1.57.0-noble + image: mcr.microsoft.com/playwright/python:v1.58.0-noble script: ... ``` diff --git a/python/docs/docker.mdx b/python/docs/docker.mdx index a93756b1b0a..beeb3768056 100644 --- a/python/docs/docker.mdx +++ b/python/docs/docker.mdx @@ -22,7 +22,7 @@ This Docker image is intended to be used for testing and development purposes on ### Pull the image ```bash -docker pull mcr.microsoft.com/playwright/python:v1.57.0-noble +docker pull mcr.microsoft.com/playwright/python:v1.58.0-noble ``` ### Run the image @@ -34,7 +34,7 @@ By default, the Docker image will use the `root` user to run the browsers. This On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers. ```bash -docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.57.0-noble /bin/bash +docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.58.0-noble /bin/bash ``` #### Crawling and scraping @@ -42,7 +42,7 @@ docker run -it --rm --ipc=host mcr.microsoft.com/playwright/python:v1.57.0-noble On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it. ```bash -docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/python:v1.57.0-noble /bin/bash +docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright/python:v1.58.0-noble /bin/bash ``` [`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/main/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions: @@ -82,7 +82,7 @@ You can run Playwright Server in Docker while keeping your tests running on the Start the Playwright Server in Docker: ```bash -docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.57.0-noble /bin/sh -c "npx -y playwright@1.57.0 run-server --port 3000 --host 0.0.0.0" +docker run -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" ``` #### Connecting to the Server @@ -122,7 +122,7 @@ async with async_playwright() as p: If you need to access local servers from within the Docker container: ```bash -docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.57.0-noble /bin/sh -c "npx -y playwright@1.57.0 run-server --port 3000 --host 0.0.0.0" +docker run --add-host=hostmachine:host-gateway -p 3000:3000 --rm --init -it --workdir /home/pwuser --user pwuser mcr.microsoft.com/playwright:v1.58.0-noble /bin/sh -c "npx -y playwright@1.58.0 run-server --port 3000 --host 0.0.0.0" ``` This makes `hostmachine` point to the host's localhost. Your tests should use `hostmachine` instead of `localhost` when accessing local servers. @@ -155,9 +155,9 @@ Once this is enabled you can open the port specified in a new browser tab and yo See [all available image tags]. We currently publish images with the following tags: -- `:v1.57.0` - Playwright v1.57.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.57.0-noble` - Playwright v1.57.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). -- `:v1.57.0-jammy` - Playwright v1.57.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). +- `:v1.58.0` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.0-noble` - Playwright v1.58.0 release docker image based on Ubuntu 24.04 LTS (Noble Numbat). +- `:v1.58.0-jammy` - Playwright v1.58.0 release docker image based on Ubuntu 22.04 LTS (Jammy Jellyfish). :::note @@ -181,7 +181,7 @@ To run Playwright inside Docker, you need to have Python, [Playwright browsers]( ```Dockerfile FROM python:3.12-bookworm -RUN pip install playwright==@1.57.0 && \ +RUN pip install playwright==@1.58.0 && \ playwright install --with-deps ``` diff --git a/src/components/GitHubStarButton/index.tsx b/src/components/GitHubStarButton/index.tsx index 02018822103..cd9e2810a31 100644 --- a/src/components/GitHubStarButton/index.tsx +++ b/src/components/GitHubStarButton/index.tsx @@ -6,7 +6,7 @@ type StarButtonProps = { repo: string } -const STARS = '81k+'; // NOTE: this line is generated by src/generate.js. Do not change! +const STARS = '82k+'; // NOTE: this line is generated by src/generate.js. Do not change! const StarButton: React.FC = ({owner, repo}) => { if (!repo)