chore: roll Python to 1.17 beta driver (#1030)

Author: aslushnikov

playwright/async_api/_generated.py

@@ -3273,7 +3273,7 @@ async def evaluate(self, expression: str, arg: typing.Any = None) -> typing.Any:
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
         ```py
-        body_handle = await frame.query_selector(\"body\")
+        body_handle = await frame.evaluate(\"document.body\")
         html = await frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
         await body_handle.dispose()
         ```
@@ -3362,6 +3362,8 @@ async def query_selector(
 
         Returns the ElementHandle pointing to the frame element.
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds an element matching the specified selector within the frame. See
         [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns `null`.
 
@@ -3390,6 +3392,8 @@ async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"
 
         Returns the ElementHandles pointing to the frame elements.
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects instead.
+
         The method finds all elements matching the specified selector within the frame. See
         [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns empty array.
 
@@ -3423,6 +3427,9 @@ async def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
+        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
+        web-first assertions make the code wait-for-selector-free.
+
         Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
         the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
         selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
@@ -3763,6 +3770,9 @@ async def eval_on_selector(
 
         Returns the return value of `expression`.
 
+        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
+        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
+
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
         `expression`. See [Working with selectors](./selectors.md) for more details. If no elements match the selector, the
         method throws an error.
@@ -3815,6 +3825,9 @@ async def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
+        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
+        better job.
+
         The method finds all elements matching the specified selector within the frame and passes an array of matched elements
         as a first argument to `expression`. See [Working with selectors](./selectors.md) for more details.
 
@@ -5443,7 +5456,7 @@ async def run(playwright):
             # Combine it with other selector engines.
             await page.click('tag=div >> text=\"Click me\"')
             # Can use it in any methods supporting selectors.
-            button_count = await page.eval_on_selector_all('tag=button', 'buttons => buttons.length')
+            button_count = await page.locator('tag=button').count()
             print(button_count)
             await browser.close()
 
@@ -6486,8 +6499,10 @@ async def query_selector(
     ) -> typing.Optional["ElementHandle"]:
         """Page.query_selector
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds an element matching the specified selector within the page. If no elements match the selector, the
-        return value resolves to `null`. To wait for an element on the page, use `page.wait_for_selector()`.
+        return value resolves to `null`. To wait for an element on the page, use `locator.wait_for()`.
 
         Shortcut for main frame's `frame.query_selector()`.
 
@@ -6514,6 +6529,8 @@ async def query_selector(
     async def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """Page.query_selector_all
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds all elements matching the specified selector within the page. If no elements match the selector, the
         return value resolves to `[]`.
 
@@ -6549,6 +6566,9 @@ async def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
+        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
+        web-first assertions make the code wait-for-selector-free.
+
         Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
         the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
         selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
@@ -6907,7 +6927,7 @@ async def evaluate(self, expression: str, arg: typing.Any = None) -> typing.Any:
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
         ```py
-        body_handle = await page.query_selector(\"body\")
+        body_handle = await page.evaluate(\"document.body\")
         html = await page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
         await body_handle.dispose()
         ```
@@ -7001,6 +7021,9 @@ async def eval_on_selector(
     ) -> typing.Any:
         """Page.eval_on_selector
 
+        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
+        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
+
         The method finds an element matching the specified selector within the page and passes it as a first argument to
         `expression`. If no elements match the selector, the method throws an error. Returns the value of `expression`.
 
@@ -7052,6 +7075,9 @@ async def eval_on_selector_all(
     ) -> typing.Any:
         """Page.eval_on_selector_all
 
+        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
+        better job.
+
         The method finds all elements matching the specified selector within the page and passes an array of matched elements as
         a first argument to `expression`. Returns the result of `expression` invocation.
 

playwright/sync_api/_generated.py

@@ -3222,7 +3222,7 @@ def evaluate(self, expression: str, arg: typing.Any = None) -> typing.Any:
         `ElementHandle` instances can be passed as an argument to the `frame.evaluate()`:
 
         ```py
-        body_handle = frame.query_selector(\"body\")
+        body_handle = frame.evaluate(\"document.body\")
         html = frame.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
         body_handle.dispose()
         ```
@@ -3309,6 +3309,8 @@ def query_selector(
 
         Returns the ElementHandle pointing to the frame element.
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds an element matching the specified selector within the frame. See
         [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns `null`.
 
@@ -3337,6 +3339,8 @@ def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
 
         Returns the ElementHandles pointing to the frame elements.
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects instead.
+
         The method finds all elements matching the specified selector within the frame. See
         [Working with selectors](./selectors.md) for more details. If no elements match the selector, returns empty array.
 
@@ -3370,6 +3374,9 @@ def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
+        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
+        web-first assertions make the code wait-for-selector-free.
+
         Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
         the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
         selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
@@ -3707,6 +3714,9 @@ def eval_on_selector(
 
         Returns the return value of `expression`.
 
+        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
+        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
+
         The method finds an element matching the specified selector within the frame and passes it as a first argument to
         `expression`. See [Working with selectors](./selectors.md) for more details. If no elements match the selector, the
         method throws an error.
@@ -3759,6 +3769,9 @@ def eval_on_selector_all(
 
         Returns the return value of `expression`.
 
+        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
+        better job.
+
         The method finds all elements matching the specified selector within the frame and passes an array of matched elements
         as a first argument to `expression`. See [Working with selectors](./selectors.md) for more details.
 
@@ -5373,11 +5386,11 @@ def run(playwright):
             page.set_content('<div><button>Click me</button></div>')
 
             # Use the selector prefixed with its name.
-            button = page.query_selector('tag=button')
+            button = page.locator('tag=button')
             # Combine it with other selector engines.
             page.click('tag=div >> text=\"Click me\"')
             # Can use it in any methods supporting selectors.
-            button_count = page.eval_on_selector_all('tag=button', 'buttons => buttons.length')
+            button_count = page.locator('tag=button').count()
             print(button_count)
             browser.close()
 
@@ -6309,8 +6322,10 @@ def query_selector(
     ) -> typing.Optional["ElementHandle"]:
         """Page.query_selector
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds an element matching the specified selector within the page. If no elements match the selector, the
-        return value resolves to `null`. To wait for an element on the page, use `page.wait_for_selector()`.
+        return value resolves to `null`. To wait for an element on the page, use `locator.wait_for()`.
 
         Shortcut for main frame's `frame.query_selector()`.
 
@@ -6337,6 +6352,8 @@ def query_selector(
     def query_selector_all(self, selector: str) -> typing.List["ElementHandle"]:
         """Page.query_selector_all
 
+        > NOTE: The use of `ElementHandle` is discouraged, use `Locator` objects and web-first assertions instead.
+
         The method finds all elements matching the specified selector within the page. If no elements match the selector, the
         return value resolves to `[]`.
 
@@ -6372,6 +6389,9 @@ def wait_for_selector(
         Returns when element specified by selector satisfies `state` option. Returns `null` if waiting for `hidden` or
         `detached`.
 
+        > NOTE: Playwright automatically waits for element to be ready before performing an action. Using `Locator` objects and
+        web-first assertions make the code wait-for-selector-free.
+
         Wait for the `selector` to satisfy `state` option (either appear/disappear from dom, or become visible/hidden). If at
         the moment of calling the method `selector` already satisfies the condition, the method will return immediately. If the
         selector doesn't satisfy the condition for the `timeout` milliseconds, the function will throw.
@@ -6727,7 +6747,7 @@ def evaluate(self, expression: str, arg: typing.Any = None) -> typing.Any:
         `ElementHandle` instances can be passed as an argument to the `page.evaluate()`:
 
         ```py
-        body_handle = page.query_selector(\"body\")
+        body_handle = page.evaluate(\"document.body\")
         html = page.evaluate(\"([body, suffix]) => body.innerHTML + suffix\", [body_handle, \"hello\"])
         body_handle.dispose()
         ```
@@ -6819,6 +6839,9 @@ def eval_on_selector(
     ) -> typing.Any:
         """Page.eval_on_selector
 
+        > NOTE: This method does not wait for the element to pass actionability checks and therefore can lead to the flaky
+        tests. Use `locator.evaluate()`, other `Locator` helper methods or web-first assertions instead.
+
         The method finds an element matching the specified selector within the page and passes it as a first argument to
         `expression`. If no elements match the selector, the method throws an error. Returns the value of `expression`.
 
@@ -6870,6 +6893,9 @@ def eval_on_selector_all(
     ) -> typing.Any:
         """Page.eval_on_selector_all
 
+        > NOTE: In most cases, `locator.evaluate_all()`, other `Locator` helper methods and web-first assertions do a
+        better job.
+
         The method finds all elements matching the specified selector within the page and passes an array of matched elements as
         a first argument to `expression`. Returns the result of `expression` invocation.
 

setup.py

@@ -28,7 +28,7 @@
     InWheel = None
 from wheel.bdist_wheel import bdist_wheel as BDistWheelCommand
 
-driver_version = "1.18.0-next-1636539685000"
+driver_version = "1.17.0-1637005716000"
 
 
 def extractall(zip: zipfile.ZipFile, path: str) -> None: