From 35baf335d82e8bfb436fb2a35c3627c38af39579 Mon Sep 17 00:00:00 2001 From: Pavel Feldman Date: Wed, 27 Jan 2021 11:31:34 -0800 Subject: [PATCH] Revert "docs: update langs fields to include java (#5161)" iThis broke Python docs. --- docs/src/api/class-browsercontext.md | 2 +- docs/src/api/class-cdpsession.md | 2 +- docs/src/api/class-download.md | 2 +- docs/src/api/class-elementhandle.md | 12 ++--------- docs/src/api/class-frame.md | 26 +++++----------------- docs/src/api/class-jshandle.md | 8 ++----- docs/src/api/class-page.md | 32 +++++++--------------------- docs/src/api/class-route.md | 1 - docs/src/api/class-selectors.md | 2 +- docs/src/api/class-websocket.md | 2 +- docs/src/api/class-worker.md | 8 ++----- docs/src/api/java.md | 27 ----------------------- docs/src/api/params.md | 15 ++++--------- 13 files changed, 28 insertions(+), 111 deletions(-) delete mode 100644 docs/src/api/java.md diff --git a/docs/src/api/class-browsercontext.md b/docs/src/api/class-browsercontext.md index b2515b010a..8ca99a755a 100644 --- a/docs/src/api/class-browsercontext.md +++ b/docs/src/api/class-browsercontext.md @@ -737,7 +737,7 @@ A glob pattern, regex pattern or predicate receiving [URL] used to register a ro Optional handler function used to register a routing with [`method: BrowserContext.route`]. ## async method: BrowserContext.waitForEvent -* langs: js,python +* langs: - alias-python: expect_event - returns: <[any]> diff --git a/docs/src/api/class-cdpsession.md b/docs/src/api/class-cdpsession.md index 60e8eba815..cb06d2607b 100644 --- a/docs/src/api/class-cdpsession.md +++ b/docs/src/api/class-cdpsession.md @@ -1,5 +1,5 @@ # class: CDPSession -* langs: js,python +* langs: js, python * extends: [EventEmitter] The `CDPSession` instances are used to talk raw Chrome Devtools Protocol: diff --git a/docs/src/api/class-download.md b/docs/src/api/class-download.md index bf09bd1545..984f769ff3 100644 --- a/docs/src/api/class-download.md +++ b/docs/src/api/class-download.md @@ -39,7 +39,7 @@ not performed and user has no access to the downloaded files. ::: ## async method: Download.createReadStream -* langs: js,java +* langs: js - returns: <[null]|[Readable]> Returns readable stream for current download or `null` if download failed. diff --git a/docs/src/api/class-elementhandle.md b/docs/src/api/class-elementhandle.md index 5ca9100632..5d6307f344 100644 --- a/docs/src/api/class-elementhandle.md +++ b/docs/src/api/class-elementhandle.md @@ -58,7 +58,6 @@ ElementHandle instances can be used as an argument in [`method: Page.$eval`] and ## async method: ElementHandle.$ * langs: - - alias-java: querySelector - alias-python: query_selector - returns: <[null]|[ElementHandle]> @@ -70,7 +69,6 @@ returns `null`. ## async method: ElementHandle.$$ * langs: - - alias-java: querySelectorAll - alias-python: query_selector_all - returns: <[Array]<[ElementHandle]>> @@ -82,7 +80,6 @@ returns empty array. ## async method: ElementHandle.$eval * langs: - - alias-java: evalOnSelector - alias-python: eval_on_selector - returns: <[Serializable]> @@ -118,9 +115,7 @@ assert tweet_handle.eval_on_selector(".retweets", "node => node.innerText") = "1 ### param: ElementHandle.$eval.selector = %%-query-selector-%% ### param: ElementHandle.$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context @@ -132,7 +127,6 @@ Optional argument to pass to [`param: pageFunction`] ## async method: ElementHandle.$$eval * langs: - - alias-java: evalOnSelectorAll - alias-python: eval_on_selector_all - returns: <[Serializable]> @@ -172,9 +166,7 @@ assert feed_handle.eval_on_selector_all(".tweet", "nodes => nodes.map(n => n.inn ### param: ElementHandle.$$eval.selector = %%-query-selector-%% ### param: ElementHandle.$$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context diff --git a/docs/src/api/class-frame.md b/docs/src/api/class-frame.md index 61750d8983..003b21cbb0 100644 --- a/docs/src/api/class-frame.md +++ b/docs/src/api/class-frame.md @@ -77,7 +77,6 @@ with sync_playwright() as playwright: ## async method: Frame.$ * langs: - alias-python: query_selector - - alias-java: querySelector - returns: <[null]|[ElementHandle]> Returns the ElementHandle pointing to the frame element. @@ -91,7 +90,6 @@ returns `null`. ## async method: Frame.$$ * langs: - alias-python: query_selector_all - - alias-java: querySelectorAll - returns: <[Array]<[ElementHandle]>> Returns the ElementHandles pointing to the frame elements. @@ -105,7 +103,6 @@ returns empty array. ## async method: Frame.$eval * langs: - alias-python: eval_on_selector - - alias-java: evalOnSelector - returns: <[Serializable]> Returns the return value of [`param: pageFunction`] @@ -140,9 +137,7 @@ html = frame.eval_on_selector(".main-container", "(e, suffix) => e.outerHTML + s ### param: Frame.$eval.selector = %%-query-selector-%% ### param: Frame.$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context @@ -155,7 +150,6 @@ Optional argument to pass to [`param: pageFunction`] ## async method: Frame.$$eval * langs: - alias-python: eval_on_selector_all - - alias-java: evalOnSelectorAll - returns: <[Serializable]> Returns the return value of [`param: pageFunction`] @@ -184,9 +178,7 @@ divs_counts = frame.eval_on_selector_all("div", "(divs, min) => divs.length >= m ### param: Frame.$$eval.selector = %%-query-selector-%% ### param: Frame.$$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context @@ -486,9 +478,7 @@ body_handle.dispose() ``` ### param: Frame.evaluate.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in browser context @@ -562,9 +552,7 @@ result_handle.dispose() ``` ### param: Frame.evaluateHandle.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in the page context @@ -646,8 +634,6 @@ Attribute name to get the value for. ### option: Frame.getAttribute.timeout = %%-input-timeout-%% ## async method: Frame.goto -* langs: - - alias-java: navigate - returns: <[null]|[Response]> Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the @@ -1104,9 +1090,7 @@ frame.wait_for_function("selector => !!document.querySelector(selector)", select ``` ### param: Frame.waitForFunction.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in browser context diff --git a/docs/src/api/class-jshandle.md b/docs/src/api/class-jshandle.md index 951d82a346..c2945c57cf 100644 --- a/docs/src/api/class-jshandle.md +++ b/docs/src/api/class-jshandle.md @@ -62,9 +62,7 @@ assert tweet_handle.evaluate("node => node.innerText") == "10 retweets" ``` ### param: JSHandle.evaluate.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]> Function to be evaluated in browser context @@ -90,9 +88,7 @@ for the promise to resolve and return its value. See [`method: Page.evaluateHandle`] for more details. ### param: JSHandle.evaluateHandle.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated diff --git a/docs/src/api/class-page.md b/docs/src/api/class-page.md index dafaf91e0d..ffaaee7ae6 100644 --- a/docs/src/api/class-page.md +++ b/docs/src/api/class-page.md @@ -311,7 +311,6 @@ page. ## async method: Page.$ * langs: - - alias-java: querySelector - alias-python: query_selector - returns: <[null]|[ElementHandle]> @@ -324,7 +323,6 @@ Shortcut for main frame's [`method: Frame.$`]. ## async method: Page.$$ * langs: - - alias-java: querySelectorAll - alias-python: query_selector_all - returns: <[Array]<[ElementHandle]>> @@ -337,7 +335,6 @@ Shortcut for main frame's [`method: Frame.$$`]. ## async method: Page.$eval * langs: - - alias-java: evalOnSelector - alias-python: eval_on_selector - returns: <[Serializable]> @@ -373,9 +370,7 @@ Shortcut for main frame's [`method: Frame.$eval`]. ### param: Page.$eval.selector = %%-query-selector-%% ### param: Page.$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context @@ -387,7 +382,6 @@ Optional argument to pass to [`param: pageFunction`] ## async method: Page.$$eval * langs: - - alias-java: evalOnSelectorAll - alias-python: eval_on_selector_all - returns: <[Serializable]> @@ -414,9 +408,7 @@ div_counts = page.eval_on_selector_all("div", "(divs, min) => divs.length >= min ### param: Page.$$eval.selector = %%-query-selector-%% ### param: Page.$$eval.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context @@ -827,7 +819,7 @@ page.evaluate("matchMedia('(prefers-color-scheme: no-preference)').matches") ``` ### param: Page.emulateMedia.params -* langs: js,java +* langs: js - `params` <[Object]> - `media` <[null]|"screen"|"print"> Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null` disables CSS media emulation. Omitting `media` or passing @@ -910,9 +902,7 @@ body_handle.dispose() Shortcut for main frame's [`method: Frame.evaluate`]. ### param: Page.evaluate.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in the page context @@ -986,9 +976,7 @@ result_handle.dispose() ``` ### param: Page.evaluateHandle.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in the page context @@ -1310,7 +1298,7 @@ frame = page.frame(url=r".*domain.*") ``` ### param: Page.frame.frameSelector -* langs: js,java +* langs: js - `frameSelector` <[string]|[Object]> - `name` <[string]> Frame name specified in the `iframe`'s `name` attribute. Optional. - `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving @@ -1362,8 +1350,6 @@ Navigate to the next page in history. ### option: Page.goForward.waitUntil = %%-navigation-wait-until-%% ## async method: Page.goto -* langs: - - alias-java: navigate - returns: <[null]|[Response]> Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the @@ -2182,7 +2168,7 @@ Video object associated with this page. - `height` <[int]> page height in pixels. ## async method: Page.waitForEvent -* langs: js,python +* langs: - alias-python: expect_event - returns: <[any]> @@ -2292,9 +2278,7 @@ page.wait_for_function("selector => !!document.querySelector(selector)", selecto Shortcut for main frame's [`method: Frame.waitForFunction`]. ### param: Page.waitForFunction.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in browser context diff --git a/docs/src/api/class-route.md b/docs/src/api/class-route.md index 38e7787b95..a03442af88 100644 --- a/docs/src/api/class-route.md +++ b/docs/src/api/class-route.md @@ -30,7 +30,6 @@ Optional error code. Defaults to `failed`, could be one of the following: ## async method: Route.continue * langs: - - alias-java: continue_ - alias-python: continue_ Continues route's request with optional overrides. diff --git a/docs/src/api/class-selectors.md b/docs/src/api/class-selectors.md index ca1857a52c..a9f7f1fff2 100644 --- a/docs/src/api/class-selectors.md +++ b/docs/src/api/class-selectors.md @@ -57,7 +57,7 @@ Name that is used in selectors as a prefix, e.g. `{name: 'foo'}` enables `foo=my contain `[a-zA-Z0-9_]` characters. ### param: Selectors.register.script -* langs: js,java +* langs: js - `script` <[function]|[string]|[Object]> - `path` <[path]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working directory. Optional. diff --git a/docs/src/api/class-websocket.md b/docs/src/api/class-websocket.md index 90239389a8..e09a46d9b3 100644 --- a/docs/src/api/class-websocket.md +++ b/docs/src/api/class-websocket.md @@ -35,7 +35,7 @@ Indicates that the web socket has been closed. Contains the URL of the WebSocket. ## async method: WebSocket.waitForEvent -* langs: js,python +* langs: - alias-python: expect_event - returns: <[any]> diff --git a/docs/src/api/class-worker.md b/docs/src/api/class-worker.md index 8228fed4b4..eaea475a74 100644 --- a/docs/src/api/class-worker.md +++ b/docs/src/api/class-worker.md @@ -45,9 +45,7 @@ If the function passed to the `worker.evaluate` returns a non-[Serializable] val `-0`, `NaN`, `Infinity`, `-Infinity`, and bigint literals. ### param: Worker.evaluate.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in the worker context @@ -69,9 +67,7 @@ If the function passed to the `worker.evaluateHandle` returns a [Promise], then the promise to resolve and return its value. ### param: Worker.evaluateHandle.pageFunction -* langs: - - alias-java: expression - - alias-python: expression +* langs: js - `pageFunction` <[function]|[string]> Function to be evaluated in the page context diff --git a/docs/src/api/java.md b/docs/src/api/java.md deleted file mode 100644 index 9c045fadcf..0000000000 --- a/docs/src/api/java.md +++ /dev/null @@ -1,27 +0,0 @@ -## method: Playwright.stop -* langs: java - -Terminates this instance of Playwright. - -### param: BrowserContext.addInitScript.script -* langs: java -- `script` <[string]> - -Script to be evaluated in all pages in the browser context. - -### param: ElementHandle.$eval.expression = %%-java-evaluate-expression-%% -### param: ElementHandle.$$eval.expression = %%-java-evaluate-expression-%% -### param: Frame.$eval.expression = %%-java-evaluate-expression-%% -### param: Frame.$$eval.expression = %%-java-evaluate-expression-%% -### param: Frame.evaluate.expression = %%-java-evaluate-expression-%% -### param: Frame.evaluateHandle.expression = %%-java-evaluate-expression-%% -### param: Frame.waitForFunction.expression = %%-java-evaluate-expression-%% -### param: JSHandle.evaluate.expression = %%-java-evaluate-expression-%% -### param: JSHandle.evaluateHandle.expression = %%-java-evaluate-expression-%% -### param: Page.$eval.expression = %%-java-evaluate-expression-%% -### param: Page.$$eval.expression = %%-java-evaluate-expression-%% -### param: Page.evaluate.expression = %%-java-evaluate-expression-%% -### param: Page.evaluateHandle.expression = %%-java-evaluate-expression-%% -### param: Page.waitForFunction.expression = %%-java-evaluate-expression-%% -### param: Worker.evaluate.expression = %%-java-evaluate-expression-%% -### param: Worker.evaluateHandle.expression = %%-java-evaluate-expression-%% diff --git a/docs/src/api/params.md b/docs/src/api/params.md index 9778f52535..b658e027bc 100644 --- a/docs/src/api/params.md +++ b/docs/src/api/params.md @@ -147,7 +147,7 @@ Whether to ignore HTTPS errors during navigation. Defaults to `false`. Toggles bypassing page's Content-Security-Policy. ## context-option-viewport -* langs: js,java +* langs: js - `viewport` <[null]|[Object]> - `width` <[int]> page width in pixels. - `height` <[int]> page height in pixels. @@ -262,7 +262,7 @@ Logger sink for Playwright logging. **DEPRECATED** Use [`option: recordVideo`] instead. ## context-option-recordhar -* langs: js,java +* langs: js - `recordHar` <[Object]> - `omitContent` <[boolean]> Optional setting to control whether to omit request content from the HAR. Defaults to `false`. @@ -285,7 +285,7 @@ Optional setting to control whether to omit request content from the HAR. Defaul Path on the filesystem to write the HAR file to. ## context-option-recordvideo -* langs: js,java +* langs: js - `recordVideo` <[Object]> - `dir` <[path]> Path to the directory to put videos into. - `size` <[Object]> Optional dimensions of the recorded videos. If not specified the size will be equal to `viewport`. @@ -326,7 +326,7 @@ option to work. If all contexts override the proxy, global proxy will be never u `launch({ proxy: { server: 'per-context' } })`. ## select-options-values -* langs: js,java +* langs: js - `values` <[null]|[string]|[ElementHandle]|[Array]<[string]>|[Object]|[Array]<[ElementHandle]>|[Array]<[Object]>> - `value` <[string]> Matches by `option.value`. Optional. - `label` <[string]> Matches by `option.label`. Optional. @@ -355,13 +355,6 @@ method resolves immediately. Can be one of: * `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired. * `'networkidle'` - wait until there are no network connections for at least `500` ms. -## java-evaluate-expression -* langs: java -- `expression` <[string]> - -JavaScript expression to be evaluated in the browser context. If it looks like a function declaration, -it is interpreted as a function. Otherwise, evaluated as an expression. - ## python-select-options-element * langs: python - `element` <[ElementHandle]|[Array]<[ElementHandle]>>