diff --git a/dotnet/docs/api/class-browsercontext.mdx b/dotnet/docs/api/class-browsercontext.mdx index 88c258e2ca..dff2b25a05 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 bc77f685fe..f1875816c4 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 14d7a343fe..47133aaf4f 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 edb81d78df..85cb3ea915 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 5906070ec7..d2bf16aeb1 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 cf201dd8be..15691a0116 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 02f1989952..e94a5ef36d 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 a6d804b009..c19668b385 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 21df4c2b50..b5c7124df7 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 fac456d440..b8ef96d794 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 11d2f87c35..03e8e65fd4 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 521916f810..2febf2a5e5 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 8bdef2b174..b3384ca7a7 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 adc5ca5c43..fb9a04d810 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 1c22125261..007be540f2 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 74e053becc..5e936e8235 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 a44b77db28..c238e30c90 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 783aa4fb3b..ecade42bdf 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 c57d018a8c..0a2f24df93 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 3bc8504bab..891601de09 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 25735df6ef..21361d6159 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 3466e9bae9..c627f1a361 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 d35cd35dd8..158cf2c58d 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 2e97b9d9b7..4a0614f50c 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 5dcc69043a..99b10dc859 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 9d1e63e656..0f22d0507e 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 ef8ac08626..f957473e47 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 a93756b1b0..beeb376805 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 0201882210..cd9e2810a3 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)