diff --git a/dotnet/docs/docker.mdx b/dotnet/docs/docker.mdx index 90dd50511a..02f1989952 100644 --- a/dotnet/docs/docker.mdx +++ b/dotnet/docs/docker.mdx @@ -109,6 +109,24 @@ This makes `hostmachine` point to the host's localhost. Your tests should use `h When running tests remotely, ensure the Playwright version in your tests matches the version running in the Docker container. ::: +### Connecting using noVNC and GitHub Codespaces + +For Docker and GitHub Codespaces environments, you can view and generate tests using the `noVNC` viewer built into the Docker image. In order for the VNC webviewer to be accessible outside of the container, you can enable the `desktop-lite` feature and specify the `webPort` in your `.devcontainer/devcontainer.json` file: + +```json +{ + "image": "mcr.microsoft.com/playwright:v1.57.0", + "forwardPorts": [6080], + "features": { + "desktop-lite": { + "webPort": "6080" + } + } +} +``` + +Once this is enabled you can open the port specified in a new browser tab and you will have access to the `noVNC` web viewer. This will enable you to record tests, pick selectors, and use codegen directly on your container. + ## Image tags See [all available image tags]. diff --git a/java/docs/clock.mdx b/java/docs/clock.mdx index 64655dd6fb..2d390c25cc 100644 --- a/java/docs/clock.mdx +++ b/java/docs/clock.mdx @@ -59,7 +59,7 @@ Often you only need to fake `Date.now` while keeping the timers going. That way ``` ```java -SimpleDateFormat format = new SimpleDateFormat("yyy-MM-dd'T'HH:mm:ss"); +SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss"); page.clock().setFixedTime(format.parse("2024-02-02T10:00:00")); page.navigate("http://localhost:3333"); Locator locator = page.getByTestId("current-time"); @@ -87,7 +87,7 @@ Sometimes your timers depend on `Date.now` and are confused when the `Date.now` ```java // Initialize clock with some time before the test time and let the page load // naturally. `Date.now` will progress as the timers fire. -SimpleDateFormat format = new SimpleDateFormat("yyy-MM-dd'T'HH:mm:ss"); +SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss"); page.clock().install(new Clock.InstallOptions().setTime(format.parse("2024-02-02T08:00:00"))); page.navigate("http://localhost:3333"); Locator locator = page.getByTestId("current-time"); @@ -162,7 +162,7 @@ In rare cases, you may want to tick through time manually, firing all timers and ``` ```java -SimpleDateFormat format = new SimpleDateFormat("yyy-MM-dd'T'HH:mm:ss"); +SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss"); // Initialize clock with a specific time, let the page load naturally. page.clock().install(new Clock.InstallOptions() .setTime(format.parse("2024-02-02T08:00:00"))); diff --git a/java/docs/docker.mdx b/java/docs/docker.mdx index 8319cb65c4..7473b189fb 100644 --- a/java/docs/docker.mdx +++ b/java/docs/docker.mdx @@ -117,6 +117,24 @@ This makes `hostmachine` point to the host's localhost. Your tests should use `h When running tests remotely, ensure the Playwright version in your tests matches the version running in the Docker container. ::: +### Connecting using noVNC and GitHub Codespaces + +For Docker and GitHub Codespaces environments, you can view and generate tests using the `noVNC` viewer built into the Docker image. In order for the VNC webviewer to be accessible outside of the container, you can enable the `desktop-lite` feature and specify the `webPort` in your `.devcontainer/devcontainer.json` file: + +```json +{ + "image": "mcr.microsoft.com/playwright:v1.57.0", + "forwardPorts": [6080], + "features": { + "desktop-lite": { + "webPort": "6080" + } + } +} +``` + +Once this is enabled you can open the port specified in a new browser tab and you will have access to the `noVNC` web viewer. This will enable you to record tests, pick selectors, and use codegen directly on your container. + ## Image tags See [all available image tags]. diff --git a/java/docs/input.mdx b/java/docs/input.mdx index 1527d1df3d..7d8c57d7a9 100644 --- a/java/docs/input.mdx +++ b/java/docs/input.mdx @@ -22,7 +22,7 @@ page.getByRole(AriaRole.TEXTBOX).fill("Peter"); page.getByLabel("Birth date").fill("2020-02-02"); // Time input -page.getByLabel("Appointment time").fill("13-15"); +page.getByLabel("Appointment time").fill("13:15"); // Local datetime input page.getByLabel("Local time").fill("2020-03-02T05:15"); @@ -37,7 +37,7 @@ Using [Locator.setChecked()](/api/class-locator.mdx#locator-set-checked) is the page.getByLabel("I agree to the terms above").check(); // Assert the checked state -assertTrue(page.getByLabel("Subscribe to newsletter")).isChecked(); +assertThat(page.getByLabel("Subscribe to newsletter")).isChecked(); // Select the radio button page.getByLabel("XL").check(); diff --git a/java/docs/locators.mdx b/java/docs/locators.mdx index 0dee6602a9..6498c57b0a 100644 --- a/java/docs/locators.mdx +++ b/java/docs/locators.mdx @@ -878,7 +878,7 @@ rowLocator .setHas(page.getByRole( AriaRole.BUTTON, new Page.GetByRoleOptions().setName("Say goodbye")))) - .screenshot(new Page.ScreenshotOptions().setPath("screenshot.png")); + .screenshot(new Locator.ScreenshotOptions().setPath(Paths.get("screenshot.png"))); ``` You should now have a "screenshot.png" file in your project's root directory. diff --git a/nodejs/docs/api/class-browser.mdx b/nodejs/docs/api/class-browser.mdx index e3208aad8d..353d0e9308 100644 --- a/nodejs/docs/api/class-browser.mdx +++ b/nodejs/docs/api/class-browser.mdx @@ -168,6 +168,21 @@ If directly using this method to create [BrowserContext]s, it is best practice t - `acceptDownloads` [boolean] *(optional)*# Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted. + - `agent` [Object] *(optional)* Added in: v1.58# + - `provider` [string] + + LLM provider to use + - `model` [string] + + Model identifier within provider + - `cacheFile` [string] *(optional)* + + Cache file to use/generate code for performed actions into. Cache is not used if not specified (default). + - `cacheMode` ['force'] | ['ignore'] | ['auto'] *(optional)* + + Cache control, defauls to 'auto' + + Agent settings for [page.perform()](/api/class-page.mdx#page-perform) and [page.extract()](/api/class-page.mdx#page-extract). - `baseURL` [string] *(optional)*# When using [page.goto()](/api/class-page.mdx#page-goto), [page.route()](/api/class-page.mdx#page-route), [page.waitForURL()](/api/class-page.mdx#page-wait-for-url), [page.waitForRequest()](/api/class-page.mdx#page-wait-for-request), or [page.waitForResponse()](/api/class-page.mdx#page-wait-for-response) it takes the base URL in consideration by using the [`URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor for building the corresponding URL. Unset by default. Examples: diff --git a/nodejs/docs/api/class-page.mdx b/nodejs/docs/api/class-page.mdx index 2d070378d0..5abd0e24f3 100644 --- a/nodejs/docs/api/class-page.mdx +++ b/nodejs/docs/api/class-page.mdx @@ -701,6 +701,36 @@ const crypto = require('crypto'); --- +### extract {#page-extract} + +Added in: v1.58page.extract + +Extract information from the page using the agentic loop, return it in a given Zod format. + +**Usage** + +```js +await page.extract('List of items in the cart', z.object({ + title: z.string().describe('Item title to extract'), + price: z.string().describe('Item price to extract'), +}).array()); +``` + +**Arguments** +- `query` [string]# + + Task to perform using agentic loop. +- `schema` [z.ZodSchema]# +- `options` [Object] *(optional)* + - `maxTurns` [number] *(optional)*# + + Maximum number of agentic steps to take while extracting the information. + +**Returns** +- [Promise]<[Object]># + +--- + ### frame {#page-frame} Added before v1.9page.frame @@ -1485,6 +1515,35 @@ The [format](/api/class-page.mdx#page-pdf-option-format) options are: --- +### perform {#page-perform} + +Added in: v1.58page.perform + +Perform action using agentic loop. + +**Usage** + +```js +await page.perform('Click submit button'); +``` + +**Arguments** +- `task` [string]# + + Task to perform using agentic loop. +- `options` [Object] *(optional)* + - `key` [string] *(optional)*# + + All the agentic actions are converted to the Playwright calls and are cached. By default, they are cached globally with the `task` as a key. This option allows controlling the cache key explicitly. + - `maxTurns` [number] *(optional)*# + + Maximum number of agentic steps to take while performing this action. + +**Returns** +- [Promise]<[void]># + +--- + ### reload {#page-reload} Added before v1.9page.reload diff --git a/nodejs/docs/api/class-testoptions.mdx b/nodejs/docs/api/class-testoptions.mdx index 6e108dd169..db79a9a5cf 100644 --- a/nodejs/docs/api/class-testoptions.mdx +++ b/nodejs/docs/api/class-testoptions.mdx @@ -92,6 +92,35 @@ Learn more about [various timeouts](../test-timeouts.mdx). --- +### agent {#test-options-agent} + +Added in: v1.58testOptions.agent + +Agent settings for [page.perform()](/api/class-page.mdx#page-perform) and [page.extract()](/api/class-page.mdx#page-extract). + +**Usage** + +```js +testOptions.agent +``` + +**Type** +- [Object] + - `provider` [string] + + LLM provider to use + - `model` [string] + + Model identifier within provider + - `cacheFile` [string] *(optional)* + + Cache file to use/generate code for performed actions into. Cache is not used if not specified (default). + - `cacheMode` ['force'] | ['ignore'] | ['auto'] *(optional)* + + Cache control, defauls to 'auto' + +--- + ### baseURL {#test-options-base-url} Added in: v1.10testOptions.baseURL diff --git a/nodejs/docs/docker.mdx b/nodejs/docs/docker.mdx index 8407f59341..1fdd5d7137 100644 --- a/nodejs/docs/docker.mdx +++ b/nodejs/docs/docker.mdx @@ -115,6 +115,24 @@ This makes `hostmachine` point to the host's localhost. Your tests should use `h When running tests remotely, ensure the Playwright version in your tests matches the version running in the Docker container. ::: +### Connecting using noVNC and GitHub Codespaces + +For Docker and GitHub Codespaces environments, you can view and generate tests using the `noVNC` viewer built into the Docker image. In order for the VNC webviewer to be accessible outside of the container, you can enable the `desktop-lite` feature and specify the `webPort` in your `.devcontainer/devcontainer.json` file: + +```json +{ + "image": "mcr.microsoft.com/playwright:v1.57.0", + "forwardPorts": [6080], + "features": { + "desktop-lite": { + "webPort": "6080" + } + } +} +``` + +Once this is enabled you can open the port specified in a new browser tab and you will have access to the `noVNC` web viewer. This will enable you to record tests, pick selectors, and use codegen directly on your container. + ## Image tags See [all available image tags]. diff --git a/nodejs/docs/test-ui-mode.mdx b/nodejs/docs/test-ui-mode.mdx index 2cc4006311..5c80d026ef 100644 --- a/nodejs/docs/test-ui-mode.mdx +++ b/nodejs/docs/test-ui-mode.mdx @@ -127,7 +127,7 @@ npx playwright test --ui-port=8080 --ui-host=0.0.0.0 ``` :::note -Be aware that when specifying the `--ui-host=0.0.0.0` flag, UI Mode with your traces, the passwords and secrets is accessible from other machines inside your network. In the case of GitHub Codespaces, the ports are only accessible from your account by default. +Be aware that when specifying the `--ui-host=0.0.0.0` flag, UI Mode with your traces, the passwords and secrets are accessible from other machines inside your network. In the case of GitHub Codespaces, the ports are only accessible from your account by default. ::: diff --git a/python/docs/docker.mdx b/python/docs/docker.mdx index afb776042f..0860e007b6 100644 --- a/python/docs/docker.mdx +++ b/python/docs/docker.mdx @@ -132,6 +132,24 @@ This makes `hostmachine` point to the host's localhost. Your tests should use `h When running tests remotely, ensure the Playwright version in your tests matches the version running in the Docker container. ::: +### Connecting using noVNC and GitHub Codespaces + +For Docker and GitHub Codespaces environments, you can view and generate tests using the `noVNC` viewer built into the Docker image. In order for the VNC webviewer to be accessible outside of the container, you can enable the `desktop-lite` feature and specify the `webPort` in your `.devcontainer/devcontainer.json` file: + +```json +{ + "image": "mcr.microsoft.com/playwright:v1.57.0", + "forwardPorts": [6080], + "features": { + "desktop-lite": { + "webPort": "6080" + } + } +} +``` + +Once this is enabled you can open the port specified in a new browser tab and you will have access to the `noVNC` web viewer. This will enable you to record tests, pick selectors, and use codegen directly on your container. + ## Image tags See [all available image tags].