api

Author: Skn0tt

README.md

@@ -4,9 +4,9 @@ Playwright is a Python library to automate [Chromium](https://www.chromium.org/H
 
 |          | Linux | macOS | Windows |
 |   :---   | :---: | :---: | :---:   |
-| Chromium <!-- GEN:chromium-version -->141.0.7390.37<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->143.0.7499.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->142.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->144.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 

playwright/_impl/_accessibility.py

@@ -688,10 +688,13 @@ def _on_request_finished(
 
     def _on_console_message(self, event: Dict) -> None:
         message = ConsoleMessage(event, self._loop, self._dispatcher_fiber)
-        self.emit(BrowserContext.Events.Console, message)
+        worker = message.worker
+        if worker:
+            worker.emit(Worker.Events.Console, message)
         page = message.page
         if page:
             page.emit(Page.Events.Console, message)
+        self.emit(BrowserContext.Events.Console, message)
 
     def _on_dialog(self, dialog: Dialog) -> None:
         has_listeners = self.emit(BrowserContext.Events.Dialog, dialog)

playwright/_impl/_browser_context.py

@@ -21,6 +21,7 @@
 
 if TYPE_CHECKING:  # pragma: no cover
     from playwright._impl._page import Page
+    from playwright._impl._worker import Worker
 
 
 class ConsoleMessage:
@@ -31,6 +32,7 @@ def __init__(
         self._loop = loop
         self._dispatcher_fiber = dispatcher_fiber
         self._page: Optional["Page"] = from_nullable_channel(event.get("page"))
+        self._worker: Optional["Worker"] = from_nullable_channel(event.get("worker"))
 
     def __repr__(self) -> str:
         return f"<ConsoleMessage type={self.type} text={self.text}>"
@@ -76,3 +78,7 @@ def location(self) -> SourceLocation:
     @property
     def page(self) -> Optional["Page"]:
         return self._page
+
+    @property
+    def worker(self) -> Optional["Worker"]:
+        return self._worker

playwright/_impl/_console_message.py

@@ -138,6 +138,7 @@ async def click(
         force: bool = None,
         noWaitAfter: bool = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         await self._channel.send(
             "click", self._frame._timeout, locals_to_params(locals())
@@ -153,6 +154,7 @@ async def dblclick(
         force: bool = None,
         noWaitAfter: bool = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         await self._channel.send(
             "dblclick", self._frame._timeout, locals_to_params(locals())

playwright/_impl/_element_handle.py

@@ -545,6 +545,23 @@ async def click(
         noWaitAfter: bool = None,
         strict: bool = None,
         trial: bool = None,
+    ) -> None:
+        await self._click(**locals_to_params(locals()))
+
+    async def _click(
+        self,
+        selector: str,
+        modifiers: Sequence[KeyboardModifier] = None,
+        position: Position = None,
+        delay: float = None,
+        button: MouseButton = None,
+        clickCount: int = None,
+        timeout: float = None,
+        force: bool = None,
+        noWaitAfter: bool = None,
+        strict: bool = None,
+        trial: bool = None,
+        steps: int = None,
     ) -> None:
         await self._channel.send("click", self._timeout, locals_to_params(locals()))
 
@@ -734,6 +751,7 @@ async def drag_and_drop(
         strict: bool = None,
         timeout: float = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         await self._channel.send(
             "dragAndDrop", self._timeout, locals_to_params(locals())

playwright/_impl/_frame.py

@@ -14,6 +14,7 @@
 
 import json
 import pathlib
+import re
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -155,9 +156,10 @@ async def click(
         force: bool = None,
         noWaitAfter: bool = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         params = locals_to_params(locals())
-        return await self._frame.click(self._selector, strict=True, **params)
+        return await self._frame._click(self._selector, strict=True, **params)
 
     async def dblclick(
         self,
@@ -169,6 +171,7 @@ async def dblclick(
         force: bool = None,
         noWaitAfter: bool = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         params = locals_to_params(locals())
         return await self._frame.dblclick(self._selector, strict=True, **params)
@@ -343,6 +346,20 @@ def describe(self, description: str) -> "Locator":
             f"{self._selector} >> internal:describe={json.dumps(description)}",
         )
 
+    @property
+    def description(self) -> Optional[str]:
+        try:
+            match = re.search(
+                r' >> internal:describe=("(?:[^"\\]|\\.)*")$', self._selector
+            )
+            if match:
+                description = json.loads(match.group(1))
+                if isinstance(description, str):
+                    return description
+        except (json.JSONDecodeError, ValueError):
+            pass
+        return None
+
     def filter(
         self,
         hasText: Union[str, Pattern[str]] = None,
@@ -414,6 +431,7 @@ async def drag_to(
         trial: bool = None,
         sourcePosition: Position = None,
         targetPosition: Position = None,
+        steps: int = None,
     ) -> None:
         params = locals_to_params(locals())
         del params["target"]

playwright/_impl/_locator.py

@@ -33,7 +33,6 @@
     cast,
 )
 
-from playwright._impl._accessibility import Accessibility
 from playwright._impl._api_structures import (
     AriaRole,
     FilePayload,
@@ -150,7 +149,6 @@ class Page(ChannelOwner):
         WebSocket="websocket",
         Worker="worker",
     )
-    accessibility: Accessibility
     keyboard: Keyboard
     mouse: Mouse
     touchscreen: Touchscreen
@@ -160,7 +158,6 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._browser_context = cast("BrowserContext", parent)
-        self.accessibility = Accessibility(self._channel)
         self.keyboard = Keyboard(self._channel)
         self.mouse = Mouse(self._channel)
         self.touchscreen = Touchscreen(self._channel)
@@ -854,7 +851,7 @@ async def click(
         trial: bool = None,
         strict: bool = None,
     ) -> None:
-        return await self._main_frame.click(**locals_to_params(locals()))
+        return await self._main_frame._click(**locals_to_params(locals()))
 
     async def dblclick(
         self,
@@ -1017,6 +1014,7 @@ async def drag_and_drop(
         timeout: float = None,
         strict: bool = None,
         trial: bool = None,
+        steps: int = None,
     ) -> None:
         return await self._main_frame.drag_and_drop(**locals_to_params(locals()))
 
@@ -1452,12 +1450,13 @@ async def page_errors(self) -> List[Error]:
 
 
 class Worker(ChannelOwner):
-    Events = SimpleNamespace(Close="close")
+    Events = SimpleNamespace(Close="close", Console="console")
 
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
+        self._set_event_to_subscription_mapping({Worker.Events.Console: "console"})
         self._channel.on("close", lambda _: self._on_close())
         self._page: Optional[Page] = None
         self._context: Optional["BrowserContext"] = None
@@ -1502,6 +1501,31 @@ async def evaluate_handle(
             )
         )
 
+    def expect_event(
+        self,
+        event: str,
+        predicate: Callable = None,
+        timeout: float = None,
+    ) -> EventContextManagerImpl:
+        if timeout is None:
+            if self._page:
+                timeout = self._page._timeout_settings.timeout()
+            elif self._context:
+                timeout = self._context._timeout_settings.timeout()
+            else:
+                timeout = 30000
+        waiter = Waiter(self, f"worker.expect_event({event})")
+        waiter.reject_on_timeout(
+            cast(float, timeout),
+            f'Timeout {timeout}ms exceeded while waiting for event "{event}"',
+        )
+        if event != Worker.Events.Close:
+            waiter.reject_on_event(
+                self, Worker.Events.Close, lambda: TargetClosedError()
+            )
+        waiter.wait_for_event(self, event, predicate)
+        return EventContextManagerImpl(waiter.result())
+
 
 class BindingCall(ChannelOwner):
     def __init__(

playwright/_impl/_page.py

@@ -30,7 +30,6 @@
 from playwright._impl._assertions import PageAssertions as PageAssertionsImpl
 from playwright.async_api._context_manager import PlaywrightContextManager
 from playwright.async_api._generated import (
-    Accessibility,
     APIRequest,
     APIRequestContext,
     APIResponse,
@@ -150,7 +149,6 @@ def __call__(
 __all__ = [
     "expect",
     "async_playwright",
-    "Accessibility",
     "APIRequest",
     "APIRequestContext",
     "APIResponse",