diff --git a/docs/src/api/class-android.md b/docs/src/api/class-android.md index 16c9e31f44..88f003e331 100644 --- a/docs/src/api/class-android.md +++ b/docs/src/api/class-android.md @@ -5,14 +5,12 @@ Playwright has **experimental** support for Android automation. This includes Chrome for Android and Android WebView. *Requirements* - * Android device or AVD Emulator. * [ADB daemon](https://developer.android.com/studio/command-line/adb) running and authenticated with your device. Typically running `adb devices` is all you need to do. * [`Chrome 87`](https://play.google.com/store/apps/details?id=com.android.chrome) or newer installed on the device * "Enable command line on non-rooted devices" enabled in `chrome://flags`. *Known limitations* - * Raw USB operation is not yet supported, so you need ADB. * Device needs to be awake to produce screenshots. Enabling "Stay awake" developer mode will help. * We didn't run all the tests against the device, so not everything works. diff --git a/docs/src/api/class-androiddevice.md b/docs/src/api/class-androiddevice.md index 258946fe92..6ab8f95329 100644 --- a/docs/src/api/class-androiddevice.md +++ b/docs/src/api/class-androiddevice.md @@ -173,7 +173,6 @@ Launches a process in the shell on the device and returns a socket to communicat * since: v1.9 - `command` <[string]> Shell command to execute. - ## async method: AndroidDevice.pinchClose * since: v1.9 @@ -344,7 +343,6 @@ Executes a shell command on the device and returns its output. Shell command to execute. - ## async method: AndroidDevice.swipe * since: v1.9 diff --git a/docs/src/api/class-androidinput.md b/docs/src/api/class-androidinput.md index b68178efaf..3d541b494b 100644 --- a/docs/src/api/class-androidinput.md +++ b/docs/src/api/class-androidinput.md @@ -40,7 +40,6 @@ Presses the [`param: key`]. Key to press. - ## async method: AndroidInput.swipe * since: v1.9 diff --git a/docs/src/api/class-androidwebview.md b/docs/src/api/class-androidwebview.md index 1d4b7eacf4..960e50f4cf 100644 --- a/docs/src/api/class-androidwebview.md +++ b/docs/src/api/class-androidwebview.md @@ -25,4 +25,4 @@ WebView process PID. * since: v1.9 - returns: <[string]> -WebView package identifier. \ No newline at end of file +WebView package identifier. diff --git a/docs/src/api/class-apirequest.md b/docs/src/api/class-apirequest.md index 8142da9a47..164de27b2e 100644 --- a/docs/src/api/class-apirequest.md +++ b/docs/src/api/class-apirequest.md @@ -14,12 +14,16 @@ Creates new instances of [APIRequestContext]. ### option: APIRequest.newContext.useragent = %%-context-option-useragent-%% * since: v1.16 + ### option: APIRequest.newContext.extraHTTPHeaders = %%-context-option-extrahttpheaders-%% * since: v1.16 + ### option: APIRequest.newContext.httpCredentials = %%-context-option-httpcredentials-%% * since: v1.16 + ### option: APIRequest.newContext.proxy = %%-browser-option-proxy-%% * since: v1.16 + ### option: APIRequest.newContext.ignoreHTTPSErrors = %%-context-option-ignorehttpserrors-%% * since: v1.16 @@ -30,7 +34,6 @@ Creates new instances of [APIRequestContext]. Maximum time in milliseconds to wait for the response. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. - ### option: APIRequest.newContext.baseURL * since: v1.16 - `baseURL` <[string]> diff --git a/docs/src/api/class-apirequestcontext.md b/docs/src/api/class-apirequestcontext.md index 9ceafa3978..932b5e198c 100644 --- a/docs/src/api/class-apirequestcontext.md +++ b/docs/src/api/class-apirequestcontext.md @@ -137,30 +137,43 @@ context cookies from the response. The method will automatically follow redirect ### param: APIRequestContext.delete.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.delete.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.delete.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.delete.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.delete.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.delete.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.17 + ### option: APIRequestContext.delete.form = %%-js-python-fetch-option-form-%% * since: v1.17 + ### option: APIRequestContext.delete.form = %%-csharp-fetch-option-form-%% * since: v1.17 + ### option: APIRequestContext.delete.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.17 + ### option: APIRequestContext.delete.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.17 + ### option: APIRequestContext.delete.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.delete.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.delete.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.delete.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -285,8 +298,10 @@ Target URL or Request to get all parameters from. ### param: APIRequestContext.fetch.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.fetch.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.fetch.params = %%-csharp-fetch-option-params-%% * since: v1.16 @@ -300,22 +315,31 @@ If set changes the fetch method (e.g. [PUT](https://developer.mozilla.org/en-US/ ### option: APIRequestContext.fetch.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.fetch.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.16 + ### option: APIRequestContext.fetch.form = %%-js-python-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.fetch.form = %%-csharp-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.fetch.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.fetch.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.fetch.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.fetch.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.fetch.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.fetch.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -363,30 +387,43 @@ await request.GetAsync("https://example.com/api/getText", new() { Params = param ### param: APIRequestContext.get.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.get.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.get.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.get.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.get.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.get.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.26 + ### option: APIRequestContext.get.form = %%-js-python-fetch-option-form-%% * since: v1.26 + ### option: APIRequestContext.get.form = %%-csharp-fetch-option-form-%% * since: v1.26 + ### option: APIRequestContext.get.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.26 + ### option: APIRequestContext.get.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.26 + ### option: APIRequestContext.get.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.get.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.get.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.get.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -400,30 +437,43 @@ context cookies from the response. The method will automatically follow redirect ### param: APIRequestContext.head.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.head.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.head.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.head.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.head.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.head.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.26 + ### option: APIRequestContext.head.form = %%-js-python-fetch-option-form-%% * since: v1.26 + ### option: APIRequestContext.head.form = %%-csharp-fetch-option-form-%% * since: v1.26 + ### option: APIRequestContext.head.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.26 + ### option: APIRequestContext.head.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.26 + ### option: APIRequestContext.head.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.head.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.head.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.head.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -437,30 +487,43 @@ context cookies from the response. The method will automatically follow redirect ### param: APIRequestContext.patch.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.patch.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.patch.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.patch.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.patch.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.patch.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.16 + ### option: APIRequestContext.patch.form = %%-js-python-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.patch.form = %%-csharp-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.patch.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.patch.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.patch.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.patch.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.patch.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.patch.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -602,30 +665,43 @@ await request.PostAsync("https://example.com/api/uploadScript", new() { Multipar ### param: APIRequestContext.post.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.post.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.post.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.post.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.post.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.post.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.16 + ### option: APIRequestContext.post.form = %%-js-python-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.post.form = %%-csharp-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.post.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.post.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.post.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.post.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.post.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.post.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 @@ -639,30 +715,43 @@ context cookies from the response. The method will automatically follow redirect ### param: APIRequestContext.put.url = %%-fetch-param-url-%% * since: v1.16 + ### param: APIRequestContext.put.params = %%-java-csharp-fetch-params-%% * since: v1.18 + ### option: APIRequestContext.put.params = %%-js-python-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.put.params = %%-csharp-fetch-option-params-%% * since: v1.16 + ### option: APIRequestContext.put.headers = %%-js-python-csharp-fetch-option-headers-%% * since: v1.16 + ### option: APIRequestContext.put.data = %%-js-python-csharp-fetch-option-data-%% * since: v1.16 + ### option: APIRequestContext.put.form = %%-js-python-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.put.form = %%-csharp-fetch-option-form-%% * since: v1.16 + ### option: APIRequestContext.put.multipart = %%-js-python-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.put.multipart = %%-csharp-fetch-option-multipart-%% * since: v1.16 + ### option: APIRequestContext.put.timeout = %%-js-python-csharp-fetch-option-timeout-%% * since: v1.16 + ### option: APIRequestContext.put.failOnStatusCode = %%-js-python-csharp-fetch-option-failonstatuscode-%% * since: v1.16 + ### option: APIRequestContext.put.ignoreHTTPSErrors = %%-js-python-csharp-fetch-option-ignorehttpserrors-%% * since: v1.16 + ### option: APIRequestContext.put.maxRedirects = %%-js-python-csharp-fetch-option-maxredirects-%% * since: v1.26 diff --git a/docs/src/api/class-apiresponseassertions.md b/docs/src/api/class-apiresponseassertions.md index 27e699073f..c045ae679f 100644 --- a/docs/src/api/class-apiresponseassertions.md +++ b/docs/src/api/class-apiresponseassertions.md @@ -46,7 +46,6 @@ def test_navigates_to_login_page(page: Page) -> None: expect(response).to_be_ok() ``` - ## property: APIResponseAssertions.not * since: v1.20 * langs: java, js, csharp diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md index 7621c017cd..e4d1fbee89 100644 --- a/docs/src/api/class-browsercontext.md +++ b/docs/src/api/class-browsercontext.md @@ -73,7 +73,6 @@ Only works with Chromium browser's persistent context. Emitted when new background page is created in the context. - ```js const backgroundPage = await context.waitForEvent('backgroundpage'); ``` @@ -1083,7 +1082,6 @@ Path to a [HAR](http://www.softwareishard.com/blog/har-12-spec) file with prerec ### option: BrowserContext.routeFromHAR.notFound * since: v1.23 - `notFound` ?<[HarNotFound]<"abort"|"fallback">> - * If set to 'abort' any request not found in the HAR file will be aborted. * If set to 'fallback' falls through to the next route handler in the handler chain. @@ -1380,7 +1378,9 @@ Will throw an error if the browser context is closed before the `event` is fired ### param: BrowserContext.waitForEvent2.event = %%-wait-for-event-event-%% * since: v1.8 + ### option: BrowserContext.waitForEvent2.predicate = %%-wait-for-event-predicate-%% * since: v1.8 + ### option: BrowserContext.waitForEvent2.timeout = %%-wait-for-event-timeout-%% * since: v1.8 diff --git a/docs/src/api/class-browsertype.md b/docs/src/api/class-browsertype.md index 425efe80c7..a9b229b7db 100644 --- a/docs/src/api/class-browsertype.md +++ b/docs/src/api/class-browsertype.md @@ -264,20 +264,25 @@ describes some differences for Linux users. ### option: BrowserType.launch.-inline- = %%-shared-browser-options-list-v1.8-%% * since: v1.8 + ### option: BrowserType.launch.firefoxUserPrefs = %%-js-python-browser-option-firefoxuserprefs-%% * since: v1.8 + ### option: BrowserType.launch.firefoxUserPrefs2 = %%-csharp-java-browser-option-firefoxuserprefs-%% * since: v1.8 + ### option: BrowserType.launch.logger = %%-browser-option-logger-%% * since: v1.8 + ### option: BrowserType.launch.slowMo = %%-browser-option-slowmo-%% * since: v1.8 + ### option: BrowserType.launch.ignoreDefaultArgs = %%-csharp-java-browser-option-ignoredefaultargs-%% * since: v1.8 + ### option: BrowserType.launch.ignoreAllDefaultArgs = %%-csharp-java-browser-option-ignorealldefaultargs-%% * since: v1.9 - ## async method: BrowserType.launchPersistentContext * since: v1.8 - returns: <[BrowserContext]> @@ -299,12 +304,16 @@ use a temporary directory instead. ### option: BrowserType.launchPersistentContext.-inline- = %%-shared-browser-options-list-v1.8-%% * since: v1.8 + ### option: BrowserType.launchPersistentContext.slowMo = %%-browser-option-slowmo-%% * since: v1.8 + ### option: BrowserType.launchPersistentContext.ignoreDefaultArgs = %%-csharp-java-browser-option-ignoredefaultargs-%% * since: v1.8 + ### option: BrowserType.launchPersistentContext.ignoreAllDefaultArgs = %%-csharp-java-browser-option-ignorealldefaultargs-%% * since: v1.9 + ### option: BrowserType.launchPersistentContext.-inline- = %%-shared-context-params-list-v1.8-%% * since: v1.8 @@ -333,10 +342,13 @@ const { chromium } = require('playwright'); // Or 'webkit' or 'firefox'. ### option: BrowserType.launchServer.-inline- = %%-shared-browser-options-list-v1.8-%% * since: v1.8 + ### option: BrowserType.launchServer.firefoxUserPrefs = %%-js-python-browser-option-firefoxuserprefs-%% * since: v1.8 + ### option: BrowserType.launchServer.firefoxUserPrefs2 = %%-csharp-java-browser-option-firefoxuserprefs-%% * since: v1.8 + ### option: BrowserType.launchServer.logger = %%-browser-option-logger-%% * since: v1.8 diff --git a/docs/src/api/class-electron.md b/docs/src/api/class-electron.md index 57baacb92e..8188504733 100644 --- a/docs/src/api/class-electron.md +++ b/docs/src/api/class-electron.md @@ -91,33 +91,48 @@ Maximum time in milliseconds to wait for the application to start. Defaults to ` ### option: Electron.launch.acceptdownloads = %%-context-option-acceptdownloads-%% * since: v1.12 + ### option: Electron.launch.bypassCSP = %%-context-option-bypasscsp-%% * since: v1.12 + ### option: Electron.launch.colorScheme = %%-context-option-colorscheme-%% * since: v1.12 + ### option: Electron.launch.extraHTTPHeaders = %%-context-option-extrahttpheaders-%% * since: v1.12 + ### option: Electron.launch.geolocation = %%-context-option-geolocation-%% * since: v1.12 + ### option: Electron.launch.httpcredentials = %%-context-option-httpcredentials-%% * since: v1.12 + ### option: Electron.launch.ignoreHTTPSErrors = %%-context-option-ignorehttpserrors-%% * since: v1.12 + ### option: Electron.launch.locale = %%-context-option-locale-%% * since: v1.12 + ### option: Electron.launch.offline = %%-context-option-offline-%% * since: v1.12 + ### option: Electron.launch.recordhar = %%-context-option-recordhar-%% * since: v1.12 + ### option: Electron.launch.recordharpath = %%-context-option-recordhar-path-%% * since: v1.12 + ### option: Electron.launch.recordHarOmitContent = %%-context-option-recordhar-omit-content-%% * since: v1.12 + ### option: Electron.launch.recordvideo = %%-context-option-recordvideo-%% * since: v1.12 + ### option: Electron.launch.recordvideodir = %%-context-option-recordvideo-dir-%% * since: v1.12 + ### option: Electron.launch.recordvideosize = %%-context-option-recordvideo-size-%% * since: v1.12 + ### option: Electron.launch.timezoneId = %%-context-option-timezoneid-%% * since: v1.12 diff --git a/docs/src/api/class-elementhandle.md b/docs/src/api/class-elementhandle.md index 484ea9f4e1..295acb425d 100644 --- a/docs/src/api/class-elementhandle.md +++ b/docs/src/api/class-elementhandle.md @@ -504,8 +504,10 @@ Value to set for the ``, `