From 3d1b875a9cc7d975fefb3058022ed31068421950 Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Mon, 24 Nov 2025 16:39:37 +0100
Subject: [PATCH 01/13] chore: roll to 1.57.0-beta-1763718928000 (#3007)

---
 README.md                            |   4 +-
 playwright/_impl/_accessibility.py   |  69 -----
 playwright/_impl/_browser_context.py |   5 +-
 playwright/_impl/_console_message.py |   6 +
 playwright/_impl/_element_handle.py  |   2 +
 playwright/_impl/_frame.py           |  18 ++
 playwright/_impl/_glob.py            |  11 +-
 playwright/_impl/_helper.py          |  68 +++--
 playwright/_impl/_locator.py         |  20 +-
 playwright/_impl/_page.py            |  34 ++-
 playwright/async_api/__init__.py     |   2 -
 playwright/async_api/_generated.py   | 231 ++++++++++------
 playwright/sync_api/__init__.py      |   2 -
 playwright/sync_api/_generated.py    | 217 +++++++++------
 scripts/expected_api_mismatch.txt    |   3 -
 scripts/generate_api.py              |   3 -
 setup.py                             |   4 +-
 tests/async/test_accessibility.py    | 388 --------------------------
 tests/async/test_click.py            |  32 +++
 tests/async/test_locators.py         |  39 +++
 tests/async/test_page.py             | 100 +++++++
 tests/async/test_page_route.py       |  14 +
 tests/async/test_worker.py           |  39 +++
 tests/sync/test_accessibility.py     | 393 ---------------------------
 24 files changed, 639 insertions(+), 1065 deletions(-)
 delete mode 100644 playwright/_impl/_accessibility.py
 delete mode 100644 tests/async/test_accessibility.py
 delete mode 100644 tests/sync/test_accessibility.py

diff --git a/README.md b/README.md
index b54d5a364..c1797dfe0 100644
--- a/README.md
+++ b/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
 
diff --git a/playwright/_impl/_accessibility.py b/playwright/_impl/_accessibility.py
deleted file mode 100644
index fe6909c21..000000000
--- a/playwright/_impl/_accessibility.py
+++ /dev/null
@@ -1,69 +0,0 @@
-# Copyright (c) Microsoft Corporation.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-from typing import Dict, Optional
-
-from playwright._impl._connection import Channel
-from playwright._impl._element_handle import ElementHandle
-from playwright._impl._helper import locals_to_params
-
-
-def _ax_node_from_protocol(axNode: Dict) -> Dict:
-    result = {**axNode}
-    if "valueNumber" in axNode:
-        result["value"] = axNode["valueNumber"]
-    elif "valueString" in axNode:
-        result["value"] = axNode["valueString"]
-
-    if "checked" in axNode:
-        result["checked"] = (
-            True
-            if axNode.get("checked") == "checked"
-            else (
-                False if axNode.get("checked") == "unchecked" else axNode.get("checked")
-            )
-        )
-
-    if "pressed" in axNode:
-        result["pressed"] = (
-            True
-            if axNode.get("pressed") == "pressed"
-            else (
-                False if axNode.get("pressed") == "released" else axNode.get("pressed")
-            )
-        )
-
-    if axNode.get("children"):
-        result["children"] = list(map(_ax_node_from_protocol, axNode["children"]))
-    if "valueNumber" in result:
-        del result["valueNumber"]
-    if "valueString" in result:
-        del result["valueString"]
-    return result
-
-
-class Accessibility:
-    def __init__(self, channel: Channel) -> None:
-        self._channel = channel
-        self._loop = channel._connection._loop
-        self._dispatcher_fiber = channel._connection._dispatcher_fiber
-
-    async def snapshot(
-        self, interestingOnly: bool = None, root: ElementHandle = None
-    ) -> Optional[Dict]:
-        params = locals_to_params(locals())
-        if root:
-            params["root"] = root._channel
-        result = await self._channel.send("accessibilitySnapshot", None, params)
-        return _ax_node_from_protocol(result) if result else None
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index bab7d1bf1..f56564a27 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.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)
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index 53c0dee95..7866df2ae 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.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
diff --git a/playwright/_impl/_element_handle.py b/playwright/_impl/_element_handle.py
index 1561e19fc..3854669d0 100644
--- a/playwright/_impl/_element_handle.py
+++ b/playwright/_impl/_element_handle.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())
diff --git a/playwright/_impl/_frame.py b/playwright/_impl/_frame.py
index fe19a576d..b976667e7 100644
--- a/playwright/_impl/_frame.py
+++ b/playwright/_impl/_frame.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())
diff --git a/playwright/_impl/_glob.py b/playwright/_impl/_glob.py
index a0e6dcd4b..b38826996 100644
--- a/playwright/_impl/_glob.py
+++ b/playwright/_impl/_glob.py
@@ -28,12 +28,21 @@ def glob_to_regex_pattern(glob: str) -> str:
             tokens.append("\\" + char if char in escaped_chars else char)
             i += 1
         elif c == "*":
+            char_before = glob[i - 1] if i > 0 else None
             star_count = 1
             while i + 1 < len(glob) and glob[i + 1] == "*":
                 star_count += 1
                 i += 1
             if star_count > 1:
-                tokens.append("(.*)")
+                char_after = glob[i + 1] if i + 1 < len(glob) else None
+                if char_after == "/":
+                    if char_before == "/":
+                        tokens.append("((.+/)|)")
+                    else:
+                        tokens.append("(.*/)")
+                    i += 1
+                else:
+                    tokens.append("(.*)")
             else:
                 tokens.append("([^/]*)")
         else:
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 8f1ca8594..1d7e4f67b 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -35,7 +35,7 @@
     Union,
     cast,
 )
-from urllib.parse import urljoin, urlparse
+from urllib.parse import ParseResult, urljoin, urlparse, urlunparse
 
 from playwright._impl._api_structures import NameValue
 from playwright._impl._errors import (
@@ -210,8 +210,12 @@ def map_token(original: str, replacement: str) -> str:
         # Handle special case of http*://, note that the new schema has to be
         # a web schema so that slashes are properly inserted after domain.
         if index == 0 and token.endswith(":"):
-            # Using a simple replacement for the scheme part
-            processed_parts.append(map_token(token, "http:"))
+            # Replace any pattern with http:
+            if "*" in token or "{" in token:
+                processed_parts.append(map_token(token, "http:"))
+            else:
+                # Preserve explicit schema as is as it may affect trailing slashes after domain.
+                processed_parts.append(token)
             continue
         question_index = token.find("?")
         if question_index == -1:
@@ -222,55 +226,49 @@ def map_token(original: str, replacement: str) -> str:
             processed_parts.append(new_prefix + new_suffix)
 
     relative_path = "/".join(processed_parts)
-    resolved_url, case_insensitive_part = resolve_base_url(base_url, relative_path)
+    resolved, case_insensitive_part = resolve_base_url(base_url, relative_path)
 
-    for replacement, original in token_map.items():
-        normalize = case_insensitive_part and replacement in case_insensitive_part
-        resolved_url = resolved_url.replace(
-            replacement, original.lower() if normalize else original, 1
+    for token, original in token_map.items():
+        normalize = case_insensitive_part and token in case_insensitive_part
+        resolved = resolved.replace(
+            token, original.lower() if normalize else original, 1
         )
 
-    return ensure_trailing_slash(resolved_url)
+    return resolved
 
 
 def resolve_base_url(
     base_url: Optional[str], given_url: str
 ) -> Tuple[str, Optional[str]]:
     try:
-        resolved = urljoin(base_url if base_url is not None else "", given_url)
-        parsed = urlparse(resolved)
+        url = nodelike_urlparse(
+            urljoin(base_url if base_url is not None else "", given_url)
+        )
+        resolved = urlunparse(url)
         # Schema and domain are case-insensitive.
         hostname_port = (
-            parsed.hostname or ""
+            url.hostname or ""
         )  # can't use parsed.netloc because it includes userinfo (username:password)
-        if parsed.port:
-            hostname_port += f":{parsed.port}"
-        case_insensitive_prefix = f"{parsed.scheme}://{hostname_port}"
+        if url.port:
+            hostname_port += f":{url.port}"
+        case_insensitive_prefix = f"{url.scheme}://{hostname_port}"
         return resolved, case_insensitive_prefix
     except Exception:
         return given_url, None
 
 
-# In Node.js, new URL('http://localhost') returns 'http://localhost/'.
-# To ensure the same url matching behavior, do the same.
-def ensure_trailing_slash(url: str) -> str:
-    split = url.split("://", maxsplit=1)
-    if len(split) == 2:
-        # URL parser doesn't like strange/unknown schemes, so we replace it for parsing, then put it back
-        parsable_url = "http://" + split[1]
-    else:
-        # Given current rules, this should never happen _and_ still be a valid matcher. We require the protocol to be part of the match,
-        # so either the user is using a glob that starts with "*" (and none of this code is running), or the user actually has `something://` in `match`
-        parsable_url = url
-    parsed = urlparse(parsable_url, allow_fragments=True)
-    if len(split) == 2:
-        # Replace the scheme that we removed earlier
-        parsed = parsed._replace(scheme=split[0])
-    if parsed.path == "":
-        parsed = parsed._replace(path="/")
-        url = parsed.geturl()
-
-    return url
+def nodelike_urlparse(url: str) -> ParseResult:
+    parsed = urlparse(url, allow_fragments=True)
+
+    # https://url.spec.whatwg.org/#special-scheme
+    is_special_url = parsed.scheme in ["http", "https", "ws", "wss", "ftp", "file"]
+    if is_special_url:
+        # special urls have a list path, list paths are serialized as follows: https://url.spec.whatwg.org/#url-path-serializer
+        # urllib diverges, so we patch it here
+        if parsed.path == "":
+            parsed = parsed._replace(path="/")
+
+    return parsed
 
 
 class HarLookupResult(TypedDict, total=False):
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index a65b68266..2e6a7abed 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.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"]
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 29a583a7c..1f05a9048 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.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__(
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index 257ac2022..c05735fcd 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.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",
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 4c8304b25..79210603c 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -18,7 +18,6 @@
 import typing
 from typing import Literal
 
-from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
     ClientCertificate,
     Cookie,
@@ -1458,7 +1457,8 @@ async def move(
         y : float
             Y coordinate relative to the main frame's viewport in CSS pixels.
         steps : Union[int, None]
-            Defaults to 1. Sends intermediate `mousemove` events.
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(await self._impl_obj.move(x=x, y=y, steps=steps))
@@ -2084,6 +2084,7 @@ async def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """ElementHandle.click
 
@@ -2126,6 +2127,9 @@ async def click(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -2139,6 +2143,7 @@ async def click(
                 force=force,
                 noWaitAfter=no_wait_after,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -2155,6 +2160,7 @@ async def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """ElementHandle.dblclick
 
@@ -2194,6 +2200,9 @@ async def dblclick(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -2206,6 +2215,7 @@ async def dblclick(
                 force=force,
                 noWaitAfter=no_wait_after,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -3090,72 +3100,6 @@ async def wait_for_selector(
 mapping.register(ElementHandleImpl, ElementHandle)
 
 
-class Accessibility(AsyncBase):
-
-    async def snapshot(
-        self,
-        *,
-        interesting_only: typing.Optional[bool] = None,
-        root: typing.Optional["ElementHandle"] = None,
-    ) -> typing.Optional[typing.Dict]:
-        """Accessibility.snapshot
-
-        Captures the current state of the accessibility tree. The returned object represents the root accessible node of
-        the page.
-
-        **NOTE** The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen
-        readers. Playwright will discard them as well for an easier to process tree, unless `interestingOnly` is set to
-        `false`.
-
-        **Usage**
-
-        An example of dumping the entire accessibility tree:
-
-        ```py
-        snapshot = await page.accessibility.snapshot()
-        print(snapshot)
-        ```
-
-        An example of logging the focused node's name:
-
-        ```py
-        def find_focused_node(node):
-            if node.get(\"focused\"):
-                return node
-            for child in (node.get(\"children\") or []):
-                found_node = find_focused_node(child)
-                if found_node:
-                    return found_node
-            return None
-
-        snapshot = await page.accessibility.snapshot()
-        node = find_focused_node(snapshot)
-        if node:
-            print(node[\"name\"])
-        ```
-
-        Parameters
-        ----------
-        interesting_only : Union[bool, None]
-            Prune uninteresting nodes from the tree. Defaults to `true`.
-        root : Union[ElementHandle, None]
-            The root DOM element for the snapshot. Defaults to the whole page.
-
-        Returns
-        -------
-        Union[Dict, None]
-        """
-
-        return mapping.from_maybe_impl(
-            await self._impl_obj.snapshot(
-                interestingOnly=interesting_only, root=mapping.to_impl(root)
-            )
-        )
-
-
-mapping.register(AccessibilityImpl, Accessibility)
-
-
 class FileChooser(AsyncBase):
 
     @property
@@ -5357,6 +5301,7 @@ async def drag_and_drop(
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Frame.drag_and_drop
 
@@ -5388,6 +5333,9 @@ async def drag_and_drop(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -5401,6 +5349,7 @@ async def drag_and_drop(
                 strict=strict,
                 timeout=timeout,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -6600,6 +6549,7 @@ def nth(self, index: int) -> "FrameLocator":
 
 class Worker(AsyncBase):
 
+    @typing.overload
     def on(
         self,
         event: Literal["close"],
@@ -6608,8 +6558,27 @@ def on(
         """
         Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
         terminated."""
+
+    @typing.overload
+    def on(
+        self,
+        event: Literal["console"],
+        f: typing.Callable[
+            ["ConsoleMessage"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when JavaScript within the worker calls one of console API methods, e.g. `console.log` or `console.dir`.
+        """
+
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
         return super().on(event=event, f=f)
 
+    @typing.overload
     def once(
         self,
         event: Literal["close"],
@@ -6618,6 +6587,24 @@ def once(
         """
         Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
         terminated."""
+
+    @typing.overload
+    def once(
+        self,
+        event: Literal["console"],
+        f: typing.Callable[
+            ["ConsoleMessage"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when JavaScript within the worker calls one of console API methods, e.g. `console.log` or `console.dir`.
+        """
+
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
         return super().once(event=event, f=f)
 
     @property
@@ -6695,6 +6682,47 @@ async def evaluate_handle(
             )
         )
 
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager:
+        """Worker.expect_event
+
+        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
+        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+
+        **Usage**
+
+        ```py
+        async with worker.expect_event(\"console\") as event_info:
+            await worker.evaluate(\"console.log(42)\")
+        message = await event_info.value
+        ```
+
+        Parameters
+        ----------
+        event : str
+            Event name, same one typically passed into `*.on(event)`.
+        predicate : Union[Callable, None]
+            Receives the event data and resolves to truthy value when the waiting should resolve.
+        timeout : Union[float, None]
+            Maximum time to wait for in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The
+            default value can be changed by using the `browser_context.set_default_timeout()`.
+
+        Returns
+        -------
+        EventContextManager
+        """
+
+        return AsyncEventContextManager(
+            self._impl_obj.expect_event(
+                event=event, predicate=self._wrap_handler(predicate), timeout=timeout
+            ).future
+        )
+
 
 mapping.register(WorkerImpl, Worker)
 
@@ -7051,6 +7079,19 @@ def page(self) -> typing.Optional["Page"]:
         """
         return mapping.from_impl_nullable(self._impl_obj.page)
 
+    @property
+    def worker(self) -> typing.Optional["Worker"]:
+        """ConsoleMessage.worker
+
+        The web worker or service worker that produced this console message, if any. Note that console messages from web
+        workers also have non-null `console_message.page()`.
+
+        Returns
+        -------
+        Union[Worker, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.worker)
+
 
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
@@ -7825,16 +7866,6 @@ def once(
     ) -> None:
         return super().once(event=event, f=f)
 
-    @property
-    def accessibility(self) -> "Accessibility":
-        """Page.accessibility
-
-        Returns
-        -------
-        Accessibility
-        """
-        return mapping.from_impl(self._impl_obj.accessibility)
-
     @property
     def keyboard(self) -> "Keyboard":
         """Page.keyboard
@@ -10893,6 +10924,7 @@ async def drag_and_drop(
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Page.drag_and_drop
 
@@ -10940,6 +10972,9 @@ async def drag_and_drop(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -10953,6 +10988,7 @@ async def drag_and_drop(
                 timeout=timeout,
                 strict=strict,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -15338,6 +15374,30 @@ def content_frame(self) -> "FrameLocator":
         """
         return mapping.from_impl(self._impl_obj.content_frame)
 
+    @property
+    def description(self) -> typing.Optional[str]:
+        """Locator.description
+
+        Returns locator description previously set with `locator.describe()`. Returns `null` if no custom
+        description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the
+        description when available.
+
+        **Usage**
+
+        ```py
+        button = page.get_by_role(\"button\").describe(\"Subscribe button\")
+        print(button.description())  # \"Subscribe button\"
+
+        input = page.get_by_role(\"textbox\")
+        print(input.description())  # None
+        ```
+
+        Returns
+        -------
+        Union[str, None]
+        """
+        return mapping.from_maybe_impl(self._impl_obj.description)
+
     async def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
@@ -15457,6 +15517,7 @@ async def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.click
 
@@ -15521,6 +15582,9 @@ async def click(
             to `false`. Useful to wait until the element is ready for the action without performing it. Note that keyboard
             `modifiers` will be pressed regardless of `trial` to allow testing elements which are only visible when those keys
             are pressed.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -15534,6 +15598,7 @@ async def click(
                 force=force,
                 noWaitAfter=no_wait_after,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -15550,6 +15615,7 @@ async def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.dblclick
 
@@ -15595,6 +15661,9 @@ async def dblclick(
             to `false`. Useful to wait until the element is ready for the action without performing it. Note that keyboard
             `modifiers` will be pressed regardless of `trial` to allow testing elements which are only visible when those keys
             are pressed.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -15607,6 +15676,7 @@ async def dblclick(
                 force=force,
                 noWaitAfter=no_wait_after,
                 trial=trial,
+                steps=steps,
             )
         )
 
@@ -16750,6 +16820,7 @@ async def drag_to(
         trial: typing.Optional[bool] = None,
         source_position: typing.Optional[Position] = None,
         target_position: typing.Optional[Position] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.drag_to
 
@@ -16796,6 +16867,9 @@ async def drag_to(
         target_position : Union[{x: float, y: float}, None]
             Drops on the target element at this point relative to the top-left corner of the element's padding box. If not
             specified, some visible point of the element is used.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -16807,6 +16881,7 @@ async def drag_to(
                 trial=trial,
                 sourcePosition=source_position,
                 targetPosition=target_position,
+                steps=steps,
             )
         )
 
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index e901cadbf..53dee2cad 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -30,7 +30,6 @@
 from playwright._impl._assertions import PageAssertions as PageAssertionsImpl
 from playwright.sync_api._context_manager import PlaywrightContextManager
 from playwright.sync_api._generated import (
-    Accessibility,
     APIRequest,
     APIRequestContext,
     APIResponse,
@@ -149,7 +148,6 @@ def __call__(
 
 __all__ = [
     "expect",
-    "Accessibility",
     "APIRequest",
     "APIRequestContext",
     "APIResponse",
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index ced1a7d8c..0d892a0c9 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -18,7 +18,6 @@
 import typing
 from typing import Literal
 
-from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import (
     ClientCertificate,
     Cookie,
@@ -1456,7 +1455,8 @@ def move(self, x: float, y: float, *, steps: typing.Optional[int] = None) -> Non
         y : float
             Y coordinate relative to the main frame's viewport in CSS pixels.
         steps : Union[int, None]
-            Defaults to 1. Sends intermediate `mousemove` events.
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -2094,6 +2094,7 @@ def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """ElementHandle.click
 
@@ -2136,6 +2137,9 @@ def click(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -2150,6 +2154,7 @@ def click(
                     force=force,
                     noWaitAfter=no_wait_after,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -2167,6 +2172,7 @@ def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """ElementHandle.dblclick
 
@@ -2206,6 +2212,9 @@ def dblclick(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -2219,6 +2228,7 @@ def dblclick(
                     force=force,
                     noWaitAfter=no_wait_after,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -3134,74 +3144,6 @@ def wait_for_selector(
 mapping.register(ElementHandleImpl, ElementHandle)
 
 
-class Accessibility(SyncBase):
-
-    def snapshot(
-        self,
-        *,
-        interesting_only: typing.Optional[bool] = None,
-        root: typing.Optional["ElementHandle"] = None,
-    ) -> typing.Optional[typing.Dict]:
-        """Accessibility.snapshot
-
-        Captures the current state of the accessibility tree. The returned object represents the root accessible node of
-        the page.
-
-        **NOTE** The Chromium accessibility tree contains nodes that go unused on most platforms and by most screen
-        readers. Playwright will discard them as well for an easier to process tree, unless `interestingOnly` is set to
-        `false`.
-
-        **Usage**
-
-        An example of dumping the entire accessibility tree:
-
-        ```py
-        snapshot = page.accessibility.snapshot()
-        print(snapshot)
-        ```
-
-        An example of logging the focused node's name:
-
-        ```py
-        def find_focused_node(node):
-            if node.get(\"focused\"):
-                return node
-            for child in (node.get(\"children\") or []):
-                found_node = find_focused_node(child)
-                if found_node:
-                    return found_node
-            return None
-
-        snapshot = page.accessibility.snapshot()
-        node = find_focused_node(snapshot)
-        if node:
-            print(node[\"name\"])
-        ```
-
-        Parameters
-        ----------
-        interesting_only : Union[bool, None]
-            Prune uninteresting nodes from the tree. Defaults to `true`.
-        root : Union[ElementHandle, None]
-            The root DOM element for the snapshot. Defaults to the whole page.
-
-        Returns
-        -------
-        Union[Dict, None]
-        """
-
-        return mapping.from_maybe_impl(
-            self._sync(
-                self._impl_obj.snapshot(
-                    interestingOnly=interesting_only, root=mapping.to_impl(root)
-                )
-            )
-        )
-
-
-mapping.register(AccessibilityImpl, Accessibility)
-
-
 class FileChooser(SyncBase):
 
     @property
@@ -5448,6 +5390,7 @@ def drag_and_drop(
         strict: typing.Optional[bool] = None,
         timeout: typing.Optional[float] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Frame.drag_and_drop
 
@@ -5479,6 +5422,9 @@ def drag_and_drop(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -5493,6 +5439,7 @@ def drag_and_drop(
                     strict=strict,
                     timeout=timeout,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -6708,20 +6655,42 @@ def nth(self, index: int) -> "FrameLocator":
 
 class Worker(SyncBase):
 
+    @typing.overload
     def on(
         self, event: Literal["close"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
         Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
         terminated."""
+
+    @typing.overload
+    def on(
+        self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
+    ) -> None:
+        """
+        Emitted when JavaScript within the worker calls one of console API methods, e.g. `console.log` or `console.dir`.
+        """
+
+    def on(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().on(event=event, f=f)
 
+    @typing.overload
     def once(
         self, event: Literal["close"], f: typing.Callable[["Worker"], "None"]
     ) -> None:
         """
         Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is
         terminated."""
+
+    @typing.overload
+    def once(
+        self, event: Literal["console"], f: typing.Callable[["ConsoleMessage"], "None"]
+    ) -> None:
+        """
+        Emitted when JavaScript within the worker calls one of console API methods, e.g. `console.log` or `console.dir`.
+        """
+
+    def once(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().once(event=event, f=f)
 
     @property
@@ -6801,6 +6770,47 @@ def evaluate_handle(
             )
         )
 
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager:
+        """Worker.expect_event
+
+        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
+        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+
+        **Usage**
+
+        ```py
+        with worker.expect_event(\"console\") as event_info:
+            worker.evaluate(\"console.log(42)\")
+        message = event_info.value
+        ```
+
+        Parameters
+        ----------
+        event : str
+            Event name, same one typically passed into `*.on(event)`.
+        predicate : Union[Callable, None]
+            Receives the event data and resolves to truthy value when the waiting should resolve.
+        timeout : Union[float, None]
+            Maximum time to wait for in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The
+            default value can be changed by using the `browser_context.set_default_timeout()`.
+
+        Returns
+        -------
+        EventContextManager
+        """
+        return EventContextManager(
+            self,
+            self._impl_obj.expect_event(
+                event=event, predicate=self._wrap_handler(predicate), timeout=timeout
+            ).future,
+        )
+
 
 mapping.register(WorkerImpl, Worker)
 
@@ -7159,6 +7169,19 @@ def page(self) -> typing.Optional["Page"]:
         """
         return mapping.from_impl_nullable(self._impl_obj.page)
 
+    @property
+    def worker(self) -> typing.Optional["Worker"]:
+        """ConsoleMessage.worker
+
+        The web worker or service worker that produced this console message, if any. Note that console messages from web
+        workers also have non-null `console_message.page()`.
+
+        Returns
+        -------
+        Union[Worker, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.worker)
+
 
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
@@ -7829,16 +7852,6 @@ def once(
     def once(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().once(event=event, f=f)
 
-    @property
-    def accessibility(self) -> "Accessibility":
-        """Page.accessibility
-
-        Returns
-        -------
-        Accessibility
-        """
-        return mapping.from_impl(self._impl_obj.accessibility)
-
     @property
     def keyboard(self) -> "Keyboard":
         """Page.keyboard
@@ -10960,6 +10973,7 @@ def drag_and_drop(
         timeout: typing.Optional[float] = None,
         strict: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Page.drag_and_drop
 
@@ -11007,6 +11021,9 @@ def drag_and_drop(
         trial : Union[bool, None]
             When set, this method only performs the [actionability](../actionability.md) checks and skips the action. Defaults
             to `false`. Useful to wait until the element is ready for the action without performing it.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -11021,6 +11038,7 @@ def drag_and_drop(
                     timeout=timeout,
                     strict=strict,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -15382,6 +15400,30 @@ def content_frame(self) -> "FrameLocator":
         """
         return mapping.from_impl(self._impl_obj.content_frame)
 
+    @property
+    def description(self) -> typing.Optional[str]:
+        """Locator.description
+
+        Returns locator description previously set with `locator.describe()`. Returns `null` if no custom
+        description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the
+        description when available.
+
+        **Usage**
+
+        ```py
+        button = page.get_by_role(\"button\").describe(\"Subscribe button\")
+        print(button.description())  # \"Subscribe button\"
+
+        input = page.get_by_role(\"textbox\")
+        print(input.description())  # None
+        ```
+
+        Returns
+        -------
+        Union[str, None]
+        """
+        return mapping.from_maybe_impl(self._impl_obj.description)
+
     def bounding_box(
         self, *, timeout: typing.Optional[float] = None
     ) -> typing.Optional[FloatRect]:
@@ -15503,6 +15545,7 @@ def click(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.click
 
@@ -15567,6 +15610,9 @@ def click(
             to `false`. Useful to wait until the element is ready for the action without performing it. Note that keyboard
             `modifiers` will be pressed regardless of `trial` to allow testing elements which are only visible when those keys
             are pressed.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -15581,6 +15627,7 @@ def click(
                     force=force,
                     noWaitAfter=no_wait_after,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -15598,6 +15645,7 @@ def dblclick(
         force: typing.Optional[bool] = None,
         no_wait_after: typing.Optional[bool] = None,
         trial: typing.Optional[bool] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.dblclick
 
@@ -15643,6 +15691,9 @@ def dblclick(
             to `false`. Useful to wait until the element is ready for the action without performing it. Note that keyboard
             `modifiers` will be pressed regardless of `trial` to allow testing elements which are only visible when those keys
             are pressed.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between Playwright's current cursor
+            position and the provided destination. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -15656,6 +15707,7 @@ def dblclick(
                     force=force,
                     noWaitAfter=no_wait_after,
                     trial=trial,
+                    steps=steps,
                 )
             )
         )
@@ -16815,6 +16867,7 @@ def drag_to(
         trial: typing.Optional[bool] = None,
         source_position: typing.Optional[Position] = None,
         target_position: typing.Optional[Position] = None,
+        steps: typing.Optional[int] = None,
     ) -> None:
         """Locator.drag_to
 
@@ -16861,6 +16914,9 @@ def drag_to(
         target_position : Union[{x: float, y: float}, None]
             Drops on the target element at this point relative to the top-left corner of the element's padding box. If not
             specified, some visible point of the element is used.
+        steps : Union[int, None]
+            Defaults to 1. Sends `n` interpolated `mousemove` events to represent travel between the `mousedown` and `mouseup`
+            of the drag. When set to 1, emits a single `mousemove` event at the destination location.
         """
 
         return mapping.from_maybe_impl(
@@ -16873,6 +16929,7 @@ def drag_to(
                     trial=trial,
                     sourcePosition=source_position,
                     targetPosition=target_position,
+                    steps=steps,
                 )
             )
         )
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index c6b3c7a95..f47493440 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -4,9 +4,6 @@
 Parameter not documented: Browser.new_context(default_browser_type=)
 Parameter not documented: Browser.new_page(default_browser_type=)
 
-# We don't expand the type of the return value here.
-Parameter type mismatch in Accessibility.snapshot(return=): documented as Union[{role: str, name: str, value: Union[float, str], description: str, keyshortcuts: str, roledescription: str, valuetext: str, disabled: bool, expanded: bool, focused: bool, modal: bool, multiline: bool, multiselectable: bool, readonly: bool, required: bool, selected: bool, checked: Union["mixed", bool], pressed: Union["mixed", bool], level: int, valuemin: float, valuemax: float, autocomplete: str, haspopup: str, invalid: str, orientation: str, children: List[Dict]}, None], code has Union[Dict, None]
-
 # One vs two arguments in the callback, Python explicitly unions.
 Parameter type mismatch in BrowserContext.route(handler=): documented as Callable[[Route, Request], Union[Any, Any]], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
 Parameter type mismatch in BrowserContext.unroute(handler=): documented as Union[Callable[[Route, Request], Union[Any, Any]], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index b0e7e2a32..3d2f45156 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -18,7 +18,6 @@
 from typing import Any, Dict, List, Match, Optional, Union, cast, get_args, get_origin
 from typing import get_type_hints as typing_get_type_hints
 
-from playwright._impl._accessibility import Accessibility
 from playwright._impl._assertions import (
     APIResponseAssertions,
     LocatorAssertions,
@@ -225,7 +224,6 @@ def return_value(value: Any) -> List[str]:
 from typing import Literal
 
 
-from playwright._impl._accessibility import Accessibility as AccessibilityImpl
 from playwright._impl._api_structures import Cookie, SetCookieParam, FloatRect, FilePayload, Geolocation, HttpCredentials, PdfMargins, Position, ProxySettings, ResourceTiming, SourceLocation, StorageState, ClientCertificate, ViewportSize, RemoteAddr, SecurityDetails, RequestSizes, NameValue, TracingGroupLocation
 from playwright._impl._browser import Browser as BrowserImpl
 from playwright._impl._browser_context import BrowserContext as BrowserContextImpl
@@ -265,7 +263,6 @@ def return_value(value: Any) -> List[str]:
     Touchscreen,
     JSHandle,
     ElementHandle,
-    Accessibility,
     FileChooser,
     Frame,
     FrameLocator,
diff --git a/setup.py b/setup.py
index 2046c2220..1645ef7b1 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.56.1"
+driver_version = "1.57.0-beta-1763718928000"
 
 base_wheel_bundles = [
     {
@@ -102,7 +102,7 @@ def download_driver(zip_name: str) -> None:
     destination_path = "driver/" + zip_file
     if os.path.exists(destination_path):
         return
-    url = "https://playwright.azureedge.net/builds/driver/"
+    url = "https://cdn.playwright.dev/builds/driver/"
     if (
         "-alpha" in driver_version
         or "-beta" in driver_version
diff --git a/tests/async/test_accessibility.py b/tests/async/test_accessibility.py
deleted file mode 100644
index 41fe599c2..000000000
--- a/tests/async/test_accessibility.py
+++ /dev/null
@@ -1,388 +0,0 @@
-# Copyright (c) Microsoft Corporation.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import sys
-
-import pytest
-
-from playwright.async_api import Page
-
-
-async def test_accessibility_should_work(
-    page: Page, is_firefox: bool, is_chromium: bool, is_webkit: bool
-) -> None:
-    if is_webkit and sys.platform == "darwin":
-        pytest.skip("Test disabled on WebKit on macOS")
-    await page.set_content(
-        """<head>
-      <title>Accessibility Test</title>
-    </head>
-    <body>
-      <h1>Inputs</h1>
-      <input placeholder="Empty input" autofocus />
-      <input placeholder="readonly input" readonly />
-      <input placeholder="disabled input" disabled />
-      <input aria-label="Input with whitespace" value="  " />
-      <input value="value only" />
-      <input aria-placeholder="placeholder" value="and a value" />
-      <div aria-hidden="true" id="desc">This is a description!</div>
-      <input aria-placeholder="placeholder" value="and a value" aria-describedby="desc" />
-    </body>"""
-    )
-    # autofocus happens after a delay in chrome these days
-    await page.wait_for_function("document.activeElement.hasAttribute('autofocus')")
-
-    if is_firefox:
-        golden = {
-            "role": "document",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {
-                    "role": "textbox",
-                    "name": "",
-                    "value": "and a value",
-                },  # firefox doesn't use aria-placeholder for the name
-                {
-                    "role": "textbox",
-                    "name": "",
-                    "value": "and a value",
-                    "description": "This is a description!",
-                },  # and here
-            ],
-        }
-    elif is_chromium:
-        golden = {
-            "role": "WebArea",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {"role": "textbox", "name": "placeholder", "value": "and a value"},
-                {
-                    "role": "textbox",
-                    "name": "placeholder",
-                    "value": "and a value",
-                    "description": "This is a description!",
-                },
-            ],
-        }
-    else:
-        golden = {
-            "role": "WebArea",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {"role": "textbox", "name": "placeholder", "value": "and a value"},
-                {
-                    "role": "textbox",
-                    "name": "This is a description!",
-                    "value": "and a value",
-                },  # webkit uses the description over placeholder for the name
-            ],
-        }
-    assert await page.accessibility.snapshot() == golden
-
-
-async def test_accessibility_should_work_with_regular_text(
-    page: Page, is_firefox: bool
-) -> None:
-    await page.set_content("<div>Hello World</div>")
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "role": "text leaf" if is_firefox else "text",
-        "name": "Hello World",
-    }
-
-
-async def test_accessibility_roledescription(page: Page) -> None:
-    await page.set_content('<p tabIndex=-1 aria-roledescription="foo">Hi</p>')
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["roledescription"] == "foo"
-
-
-async def test_accessibility_orientation(page: Page) -> None:
-    await page.set_content(
-        '<a href="" role="slider" aria-orientation="vertical">11</a>'
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["orientation"] == "vertical"
-
-
-async def test_accessibility_autocomplete(page: Page) -> None:
-    await page.set_content('<div role="textbox" aria-autocomplete="list">hi</div>')
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["autocomplete"] == "list"
-
-
-async def test_accessibility_multiselectable(page: Page) -> None:
-    await page.set_content(
-        '<div role="grid" tabIndex=-1 aria-multiselectable=true>hey</div>'
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["multiselectable"]
-
-
-async def test_accessibility_keyshortcuts(page: Page) -> None:
-    await page.set_content(
-        '<div role="grid" tabIndex=-1 aria-keyshortcuts="foo">hey</div>'
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["keyshortcuts"] == "foo"
-
-
-async def test_accessibility_filtering_children_of_leaf_nodes_should_not_report_text_nodes_inside_controls(
-    page: Page, is_firefox: bool
-) -> None:
-    await page.set_content(
-        """
-    <div role="tablist">
-    <div role="tab" aria-selected="true"><b>Tab1</b></div>
-    <div role="tab">Tab2</div>
-    </div>"""
-    )
-    golden = {
-        "role": "document" if is_firefox else "WebArea",
-        "name": "",
-        "children": [
-            {"role": "tab", "name": "Tab1", "selected": True},
-            {"role": "tab", "name": "Tab2"},
-        ],
-    }
-    assert await page.accessibility.snapshot() == golden
-
-
-# Firefox does not support contenteditable="plaintext-only".
-# WebKit rich text accessibility is iffy
-@pytest.mark.only_browser("chromium")
-async def test_accessibility_plain_text_field_with_role_should_not_have_children(
-    page: Page,
-) -> None:
-    await page.set_content(
-        """
-    <div contenteditable="plaintext-only" role='textbox'>Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "multiline": True,
-        "name": "",
-        "role": "textbox",
-        "value": "Edit this image:",
-    }
-
-
-@pytest.mark.only_browser("chromium")
-async def test_accessibility_plain_text_field_without_role_should_not_have_content(
-    page: Page,
-) -> None:
-    await page.set_content(
-        """
-    <div contenteditable="plaintext-only">Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "name": "",
-        "role": "generic",
-        "value": "Edit this image:",
-    }
-
-
-@pytest.mark.only_browser("chromium")
-async def test_accessibility_plain_text_field_with_tabindex_and_without_role_should_not_have_content(
-    page: Page,
-) -> None:
-    await page.set_content(
-        """
-    <div contenteditable="plaintext-only" tabIndex=0>Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "name": "",
-        "role": "generic",
-        "value": "Edit this image:",
-    }
-
-
-async def test_accessibility_non_editable_textbox_with_role_and_tabIndex_and_label_should_not_have_children(
-    page: Page, is_chromium: bool, is_firefox: bool
-) -> None:
-    await page.set_content(
-        """
-      <div role="textbox" tabIndex=0 aria-checked="true" aria-label="my favorite textbox">
-        this is the inner content
-        <img alt="yo" src="fakeimg.png">
-      </div>"""
-    )
-    if is_firefox:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content yo",
-        }
-    elif is_chromium:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content ",
-        }
-    else:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content  ",
-        }
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-async def test_accessibility_checkbox_with_and_tabIndex_and_label_should_not_have_children(
-    page: Page,
-) -> None:
-    await page.set_content(
-        """
-    <div role="checkbox" tabIndex=0 aria-checked="true" aria-label="my favorite checkbox">
-    this is the inner content
-    <img alt="yo" src="fakeimg.png">
-    </div>"""
-    )
-    golden = {"role": "checkbox", "name": "my favorite checkbox", "checked": True}
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-async def test_accessibility_checkbox_without_label_should_not_have_children(
-    page: Page, is_firefox: bool
-) -> None:
-    await page.set_content(
-        """
-      <div role="checkbox" aria-checked="true">
-        this is the inner content
-        <img alt="yo" src="fakeimg.png">
-    </div>"""
-    )
-    golden = {
-        "role": "checkbox",
-        "name": "this is the inner content yo",
-        "checked": True,
-    }
-    snapshot = await page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-async def test_accessibility_should_work_a_button(page: Page) -> None:
-    await page.set_content("<button>My Button</button>")
-
-    button = await page.query_selector("button")
-    assert await page.accessibility.snapshot(root=button) == {
-        "role": "button",
-        "name": "My Button",
-    }
-
-
-async def test_accessibility_should_work_an_input(page: Page) -> None:
-    await page.set_content('<input title="My Input" value="My Value">')
-
-    input = await page.query_selector("input")
-    assert await page.accessibility.snapshot(root=input) == {
-        "role": "textbox",
-        "name": "My Input",
-        "value": "My Value",
-    }
-
-
-async def test_accessibility_should_work_on_a_menu(page: Page) -> None:
-    await page.set_content(
-        """
-        <div role="menu" title="My Menu">
-        <div role="menuitem">First Item</div>
-        <div role="menuitem">Second Item</div>
-        <div role="menuitem">Third Item</div>
-        </div>
-    """
-    )
-
-    menu = await page.query_selector('div[role="menu"]')
-    golden = {
-        "role": "menu",
-        "name": "My Menu",
-        "children": [
-            {"role": "menuitem", "name": "First Item"},
-            {"role": "menuitem", "name": "Second Item"},
-            {"role": "menuitem", "name": "Third Item"},
-        ],
-    }
-    actual = await page.accessibility.snapshot(root=menu)
-    assert actual
-    # Different per browser channel
-    if "orientation" in actual:
-        del actual["orientation"]
-    assert actual == golden
-
-
-async def test_accessibility_should_return_null_when_the_element_is_no_longer_in_DOM(
-    page: Page,
-) -> None:
-    await page.set_content("<button>My Button</button>")
-    button = await page.query_selector("button")
-    await page.eval_on_selector("button", "button => button.remove()")
-    assert await page.accessibility.snapshot(root=button) is None
-
-
-async def test_accessibility_should_show_uninteresting_nodes(page: Page) -> None:
-    await page.set_content(
-        """
-        <div id="root" role="textbox">
-        <div>
-            hello
-            <div>
-            world
-            </div>
-        </div>
-        </div>
-    """
-    )
-
-    root = await page.query_selector("#root")
-    snapshot = await page.accessibility.snapshot(root=root, interesting_only=False)
-    assert snapshot
-    assert snapshot["role"] == "textbox"
-    assert "hello" in snapshot["value"]
-    assert "world" in snapshot["value"]
-    assert snapshot["children"]
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index fd783546d..8fb06ec38 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -1111,3 +1111,35 @@ async def test_check_the_box_by_aria_role(page: Page) -> None:
     )
     await page.check("div")
     assert await page.evaluate("checkbox.getAttribute ('aria-checked')")
+
+
+async def test_click_with_tweened_mouse_movement(page: Page, browser_name: str) -> None:
+    await page.set_content(
+        """
+        <body style="margin: 0; padding: 0; height: 500px; width: 500px;">
+          <div style="position: relative; top: 280px; left: 150px; width: 100px; height: 40px">Click me</div>
+        </body>
+        """
+    )
+
+    # The test becomes flaky on WebKit without next line.
+    if browser_name == "webkit":
+        await page.evaluate("() => new Promise(requestAnimationFrame)")
+    await page.mouse.move(100, 100)
+    await page.evaluate(
+        """() => {
+        window.result = [];
+        document.addEventListener('mousemove', event => {
+          window.result.push([event.clientX, event.clientY]);
+        });
+      }"""
+    )
+    # Centerpoint at 150 + 100/2, 280 + 40/2 = 200, 300
+    await page.locator("div").click(steps=5)
+    assert await page.evaluate("result") == [
+        [120, 140],
+        [140, 180],
+        [160, 220],
+        [180, 260],
+        [200, 300],
+    ]
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 980de041f..1e49bf303 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -1152,3 +1152,42 @@ async def test_locator_should_ignore_deprecated_is_hidden_and_visible_timeout(
     div = page.locator("div")
     assert await div.is_hidden(timeout=10) is False
     assert await div.is_visible(timeout=10) is True
+
+
+async def test_description_should_return_none_for_locator_without_description(
+    page: Page,
+) -> None:
+    locator = page.locator("button")
+    assert locator.description is None
+
+
+async def test_description_should_return_description_for_locator_with_simple_description(
+    page: Page,
+) -> None:
+    locator = page.locator("button").describe("Submit button")
+    assert locator.description == "Submit button"
+
+
+async def test_description_should_return_description_with_special_characters(
+    page: Page,
+) -> None:
+    locator = page.locator("div").describe("Button with \"quotes\" and 'apostrophes'")
+    assert locator.description == "Button with \"quotes\" and 'apostrophes'"
+
+
+async def test_description_should_return_description_for_chained_locators(
+    page: Page,
+) -> None:
+    locator = page.locator("form").locator("input").describe("Form input field")
+    assert locator.description == "Form input field"
+
+
+async def test_description_should_return_description_for_locator_with_multiple_describe_calls(
+    page: Page,
+) -> None:
+    locator1 = page.locator("foo").describe("First description")
+    assert locator1.description == "First description"
+    locator2 = locator1.locator("button").describe("Second description")
+    assert locator2.description == "Second description"
+    locator3 = locator2.locator("button")
+    assert locator3.description is None
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 607c86fb3..562d98248 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -1320,6 +1320,106 @@ async def test_drag_and_drop_with_position(page: Page, server: Server) -> None:
     ]
 
 
+async def test_drag_and_drop_with_tweened_mouse_movement(page: Page) -> None:
+    await page.set_content(
+        """
+        <body style="margin: 0; padding: 0;">
+          <div style="width:100px;height:100px;background:red;" id="red"></div>
+          <div style="width:300px;height:100px;background:blue;" id="blue"></div>
+        </body>
+        """
+    )
+    events_handle = await page.evaluate_handle(
+        """
+        () => {
+            const events = [];
+            document.addEventListener('mousedown', event => {
+                events.push({
+                    type: 'mousedown',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            document.addEventListener('mouseup', event => {
+                events.push({
+                    type: 'mouseup',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            document.addEventListener('mousemove', event => {
+                events.push({
+                    type: 'mousemove',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            return events;
+        }
+        """
+    )
+    await page.drag_and_drop("#red", "#blue", steps=4)
+    assert await events_handle.json_value() == [
+        {"type": "mousemove", "x": 50, "y": 50},
+        {"type": "mousedown", "x": 50, "y": 50},
+        {"type": "mousemove", "x": 75, "y": 75},
+        {"type": "mousemove", "x": 100, "y": 100},
+        {"type": "mousemove", "x": 125, "y": 125},
+        {"type": "mousemove", "x": 150, "y": 150},
+        {"type": "mouseup", "x": 150, "y": 150},
+    ]
+
+
+async def test_locator_drag_to_with_tweened_mouse_movement(page: Page) -> None:
+    await page.set_content(
+        """
+        <body style="margin: 0; padding: 0;">
+          <div style="width:100px;height:100px;background:red;" id="red"></div>
+          <div style="width:300px;height:100px;background:blue;" id="blue"></div>
+        </body>
+        """
+    )
+    events_handle = await page.evaluate_handle(
+        """
+        () => {
+            const events = [];
+            document.addEventListener('mousedown', event => {
+                events.push({
+                    type: 'mousedown',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            document.addEventListener('mouseup', event => {
+                events.push({
+                    type: 'mouseup',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            document.addEventListener('mousemove', event => {
+                events.push({
+                    type: 'mousemove',
+                    x: event.pageX,
+                    y: event.pageY,
+                });
+            });
+            return events;
+        }
+        """
+    )
+    await page.locator("#red").drag_to(page.locator("#blue"), steps=4)
+    assert await events_handle.json_value() == [
+        {"type": "mousemove", "x": 50, "y": 50},
+        {"type": "mousedown", "x": 50, "y": 50},
+        {"type": "mousemove", "x": 75, "y": 75},
+        {"type": "mousemove", "x": 100, "y": 100},
+        {"type": "mousemove", "x": 125, "y": 125},
+        {"type": "mousemove", "x": 150, "y": 150},
+        {"type": "mouseup", "x": 150, "y": 150},
+    ]
+
+
 async def test_should_check_box_using_set_checked(page: Page) -> None:
     await page.set_content("`<input id='checkbox' type='checkbox'></input>`")
     await page.set_checked("input", True)
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index db46c330d..848a95045 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -1083,6 +1083,10 @@ def glob_to_regex(pattern: str) -> re.Pattern:
         "http://localhost:3000/signin-oidcnice"
     )
 
+    assert glob_to_regex("**/*.js").match("/foo.js")
+    assert not glob_to_regex("asd/**.js").match("/foo.js")
+    assert not glob_to_regex("**/*.js").match("bar_foo.js")
+
     # range [] is NOT supported
     assert glob_to_regex("**/api/v[0-9]").fullmatch("http://example.com/api/v[0-9]")
     assert not glob_to_regex("**/api/v[0-9]").fullmatch(
@@ -1147,6 +1151,12 @@ def glob_to_regex(pattern: str) -> re.Pattern:
     assert url_matches(None, "https://localhost:3000/?a=b", "**?a=b")
     assert url_matches(None, "https://localhost:3000/?a=b", "**=b")
 
+    # Custom schema.
+    assert url_matches(None, "my.custom.protocol://foo", "my.custom.protocol://**")
+    assert not url_matches(None, "my.p://foo", "my.{p,y}://**")
+    assert url_matches(None, "my.p://foo/", "my.{p,y}://**")
+    assert url_matches(None, "file:///foo/", "f*e://**")
+
     # This is not supported, we treat ? as a query separator.
     assert not url_matches(
         None,
@@ -1174,6 +1184,10 @@ def glob_to_regex(pattern: str) -> re.Pattern:
     assert url_matches("http://first.host/", "http://second.host/foo", "**/foo")
     assert url_matches("http://playwright.dev/", "http://localhost/", "*//localhost/")
 
+    # /**/ should match /.
+    assert url_matches(None, "https://foo/bar.js", "https://foo/**/bar.js")
+    assert url_matches(None, "https://foo/bar.js", "https://foo/**/**/bar.js")
+
     custom_prefixes = ["about", "data", "chrome", "edge", "file"]
     for prefix in custom_prefixes:
         assert url_matches(
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index bba22fc0d..cd6828053 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -201,3 +201,42 @@ async def test_workers_should_format_number_using_context_locale(
     worker = await worker_info.value
     assert await worker.evaluate("() => (10000.20).toLocaleString()") == "10\u00a0000,2"
     await context.close()
+
+
+async def test_worker_should_report_console_event(page: Page) -> None:
+    async with page.expect_worker() as worker_info:
+        await page.evaluate(
+            "() => { window.worker = new Worker(URL.createObjectURL(new Blob(['42'], { type: 'application/javascript' }))); }"
+        )
+    worker = await worker_info.value
+
+    async with worker.expect_event("console") as message1_info:
+        async with page.expect_console_message() as message2_info:
+            async with page.context.expect_console_message() as message3_info:
+                await worker.evaluate("() => { console.log('hello from worker'); }")
+
+    message1 = await message1_info.value
+    message2 = await message2_info.value
+    message3 = await message3_info.value
+
+    assert message1.text == "hello from worker"
+    assert message1 is message2
+    assert message1 is message3
+    assert message1.worker is worker
+
+
+async def test_worker_should_report_console_event_when_not_listening_on_page_or_context(
+    page: Page,
+) -> None:
+    async with page.expect_worker() as worker_info:
+        await page.evaluate(
+            "() => { window.worker = new Worker(URL.createObjectURL(new Blob(['42'], { type: 'application/javascript' }))); }"
+        )
+    worker = await worker_info.value
+
+    async with worker.expect_event("console") as message_info:
+        await worker.evaluate("() => { console.log('hello from worker'); }")
+
+    message = await message_info.value
+    assert message.text == "hello from worker"
+    assert message.worker is worker
diff --git a/tests/sync/test_accessibility.py b/tests/sync/test_accessibility.py
deleted file mode 100644
index 10ec5d1b2..000000000
--- a/tests/sync/test_accessibility.py
+++ /dev/null
@@ -1,393 +0,0 @@
-# Copyright (c) Microsoft Corporation.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-import os
-import sys
-
-import pytest
-
-from playwright.sync_api import Page
-
-
-def test_accessibility_should_work(
-    page: Page, is_firefox: bool, is_chromium: bool, is_webkit: bool
-) -> None:
-    if is_webkit and sys.platform == "darwin":
-        pytest.skip("Test disabled on WebKit on macOS")
-    page.set_content(
-        """<head>
-      <title>Accessibility Test</title>
-    </head>
-    <body>
-      <h1>Inputs</h1>
-      <input placeholder="Empty input" autofocus />
-      <input placeholder="readonly input" readonly />
-      <input placeholder="disabled input" disabled />
-      <input aria-label="Input with whitespace" value="  " />
-      <input value="value only" />
-      <input aria-placeholder="placeholder" value="and a value" />
-      <div aria-hidden="true" id="desc">This is a description!</div>
-      <input aria-placeholder="placeholder" value="and a value" aria-describedby="desc" />
-    </body>"""
-    )
-    # autofocus happens after a delay in chrome these days
-    page.wait_for_function("document.activeElement.hasAttribute('autofocus')")
-
-    if is_firefox:
-        golden = {
-            "role": "document",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {
-                    "role": "textbox",
-                    "name": "",
-                    "value": "and a value",
-                },  # firefox doesn't use aria-placeholder for the name
-                {
-                    "role": "textbox",
-                    "name": "",
-                    "value": "and a value",
-                    "description": "This is a description!",
-                },  # and here
-            ],
-        }
-    elif is_chromium:
-        golden = {
-            "role": "WebArea",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {"role": "textbox", "name": "placeholder", "value": "and a value"},
-                {
-                    "role": "textbox",
-                    "name": "placeholder",
-                    "value": "and a value",
-                    "description": "This is a description!",
-                },
-            ],
-        }
-    else:
-        golden = {
-            "role": "WebArea",
-            "name": "Accessibility Test",
-            "children": [
-                {"role": "heading", "name": "Inputs", "level": 1},
-                {"role": "textbox", "name": "Empty input", "focused": True},
-                {"role": "textbox", "name": "readonly input", "readonly": True},
-                {"role": "textbox", "name": "disabled input", "disabled": True},
-                {"role": "textbox", "name": "Input with whitespace", "value": "  "},
-                {"role": "textbox", "name": "", "value": "value only"},
-                {"role": "textbox", "name": "placeholder", "value": "and a value"},
-                {
-                    "role": "textbox",
-                    "name": (
-                        "placeholder"
-                        if (
-                            sys.platform == "darwin"
-                            and int(os.uname().release.split(".")[0]) >= 21
-                        )
-                        else "This is a description!"
-                    ),
-                    "value": "and a value",
-                },  # webkit uses the description over placeholder for the name
-            ],
-        }
-    assert page.accessibility.snapshot() == golden
-
-
-def test_accessibility_should_work_with_regular_text(
-    page: Page, is_firefox: bool
-) -> None:
-    page.set_content("<div>Hello World</div>")
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "role": "text leaf" if is_firefox else "text",
-        "name": "Hello World",
-    }
-
-
-def test_accessibility_roledescription(page: Page) -> None:
-    page.set_content('<p tabIndex=-1 aria-roledescription="foo">Hi</p>')
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["roledescription"] == "foo"
-
-
-def test_accessibility_orientation(page: Page) -> None:
-    page.set_content('<a href="" role="slider" aria-orientation="vertical">11</a>')
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["orientation"] == "vertical"
-
-
-def test_accessibility_autocomplete(page: Page) -> None:
-    page.set_content('<div role="textbox" aria-autocomplete="list">hi</div>')
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["autocomplete"] == "list"
-
-
-def test_accessibility_multiselectable(page: Page) -> None:
-    page.set_content('<div role="grid" tabIndex=-1 aria-multiselectable=true>hey</div>')
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["multiselectable"]
-
-
-def test_accessibility_keyshortcuts(page: Page) -> None:
-    page.set_content('<div role="grid" tabIndex=-1 aria-keyshortcuts="foo">hey</div>')
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0]["keyshortcuts"] == "foo"
-
-
-def test_accessibility_filtering_children_of_leaf_nodes_should_not_report_text_nodes_inside_controls(
-    page: Page, is_firefox: bool
-) -> None:
-    page.set_content(
-        """
-    <div role="tablist">
-    <div role="tab" aria-selected="true"><b>Tab1</b></div>
-    <div role="tab">Tab2</div>
-    </div>"""
-    )
-    golden = {
-        "role": "document" if is_firefox else "WebArea",
-        "name": "",
-        "children": [
-            {"role": "tab", "name": "Tab1", "selected": True},
-            {"role": "tab", "name": "Tab2"},
-        ],
-    }
-    assert page.accessibility.snapshot() == golden
-
-
-# Firefox does not support contenteditable="plaintext-only".
-# WebKit rich text accessibility is iffy
-@pytest.mark.only_browser("chromium")
-def test_accessibility_plain_text_field_with_role_should_not_have_children(
-    page: Page,
-) -> None:
-    page.set_content(
-        """
-    <div contenteditable="plaintext-only" role='textbox'>Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "multiline": True,
-        "name": "",
-        "role": "textbox",
-        "value": "Edit this image:",
-    }
-
-
-@pytest.mark.only_browser("chromium")
-def test_accessibility_plain_text_field_without_role_should_not_have_content(
-    page: Page,
-) -> None:
-    page.set_content(
-        """
-    <div contenteditable="plaintext-only">Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "name": "",
-        "role": "generic",
-        "value": "Edit this image:",
-    }
-
-
-@pytest.mark.only_browser("chromium")
-def test_accessibility_plain_text_field_with_tabindex_and_without_role_should_not_have_content(
-    page: Page,
-) -> None:
-    page.set_content(
-        """
-    <div contenteditable="plaintext-only" tabIndex=0>Edit this image:<img src="fakeimage.png" alt="my fake image"></div>"""
-    )
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == {
-        "name": "",
-        "role": "generic",
-        "value": "Edit this image:",
-    }
-
-
-def test_accessibility_non_editable_textbox_with_role_and_tabIndex_and_label_should_not_have_children(
-    page: Page, is_chromium: bool, is_firefox: bool
-) -> None:
-    page.set_content(
-        """
-      <div role="textbox" tabIndex=0 aria-checked="true" aria-label="my favorite textbox">
-        this is the inner content
-        <img alt="yo" src="fakeimg.png">
-      </div>"""
-    )
-    if is_firefox:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content yo",
-        }
-    elif is_chromium:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content ",
-        }
-    else:
-        golden = {
-            "role": "textbox",
-            "name": "my favorite textbox",
-            "value": "this is the inner content  ",
-        }
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-def test_accessibility_checkbox_with_and_tabIndex_and_label_should_not_have_children(
-    page: Page,
-) -> None:
-    page.set_content(
-        """
-    <div role="checkbox" tabIndex=0 aria-checked="true" aria-label="my favorite checkbox">
-    this is the inner content
-    <img alt="yo" src="fakeimg.png">
-    </div>"""
-    )
-    golden = {"role": "checkbox", "name": "my favorite checkbox", "checked": True}
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-def test_accessibility_checkbox_without_label_should_not_have_children(
-    page: Page,
-) -> None:
-    page.set_content(
-        """
-      <div role="checkbox" aria-checked="true">
-        this is the inner content
-        <img alt="yo" src="fakeimg.png">
-    </div>"""
-    )
-    golden = {
-        "role": "checkbox",
-        "name": "this is the inner content yo",
-        "checked": True,
-    }
-    snapshot = page.accessibility.snapshot()
-    assert snapshot
-    assert snapshot["children"][0] == golden
-
-
-def test_accessibility_should_work_a_button(page: Page) -> None:
-    page.set_content("<button>My Button</button>")
-
-    button = page.query_selector("button")
-    assert page.accessibility.snapshot(root=button) == {
-        "role": "button",
-        "name": "My Button",
-    }
-
-
-def test_accessibility_should_work_an_input(page: Page) -> None:
-    page.set_content('<input title="My Input" value="My Value">')
-
-    input = page.query_selector("input")
-    assert page.accessibility.snapshot(root=input) == {
-        "role": "textbox",
-        "name": "My Input",
-        "value": "My Value",
-    }
-
-
-def test_accessibility_should_work_on_a_menu(
-    page: Page, is_webkit: bool, is_chromium: str, browser_channel: str
-) -> None:
-    page.set_content(
-        """
-        <div role="menu" title="My Menu">
-        <div role="menuitem">First Item</div>
-        <div role="menuitem">Second Item</div>
-        <div role="menuitem">Third Item</div>
-        </div>
-    """
-    )
-
-    menu = page.query_selector('div[role="menu"]')
-    golden = {
-        "role": "menu",
-        "name": "My Menu",
-        "children": [
-            {"role": "menuitem", "name": "First Item"},
-            {"role": "menuitem", "name": "Second Item"},
-            {"role": "menuitem", "name": "Third Item"},
-        ],
-    }
-    actual = page.accessibility.snapshot(root=menu)
-    assert actual
-    # Different per browser channel
-    if "orientation" in actual:
-        del actual["orientation"]
-    assert actual == golden
-
-
-def test_accessibility_should_return_null_when_the_element_is_no_longer_in_DOM(
-    page: Page,
-) -> None:
-    page.set_content("<button>My Button</button>")
-    button = page.query_selector("button")
-    page.eval_on_selector("button", "button => button.remove()")
-    assert page.accessibility.snapshot(root=button) is None
-
-
-def test_accessibility_should_show_uninteresting_nodes(page: Page) -> None:
-    page.set_content(
-        """
-        <div id="root" role="textbox">
-        <div>
-            hello
-            <div>
-            world
-            </div>
-        </div>
-        </div>
-    """
-    )
-
-    root = page.query_selector("#root")
-    assert root
-    snapshot = page.accessibility.snapshot(root=root, interesting_only=False)
-    assert snapshot
-    assert snapshot["role"] == "textbox"
-    assert "hello" in snapshot["value"]
-    assert "world" in snapshot["value"]
-    assert snapshot["children"]

From 2d3075502f8d6e4574ae34f71b8f77f61d14903d Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Thu, 4 Dec 2025 15:24:10 +0100
Subject: [PATCH 02/13] chore: roll 1.57.0 (#3012)

---
 setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.py b/setup.py
index 1645ef7b1..a0a51c3e4 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.57.0-beta-1763718928000"
+driver_version = "1.57.0"
 
 base_wheel_bundles = [
     {

From 731b5395c3bd8dd26b9317ec8e7599a29cf99547 Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Fri, 5 Dec 2025 17:35:17 +0100
Subject: [PATCH 03/13] chore: implement Request.service_worker (#3013)

---
 playwright/_impl/_network.py       |  9 ++++++++-
 playwright/async_api/_generated.py | 18 ++++++++++++++++++
 playwright/sync_api/_generated.py  | 18 ++++++++++++++++++
 setup.py                           |  2 +-
 tests/sync/test_network.py         | 14 +++++++++++++-
 5 files changed, 58 insertions(+), 3 deletions(-)

diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index a999ce73c..9f2c29f6e 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -66,7 +66,7 @@
     from playwright._impl._browser_context import BrowserContext
     from playwright._impl._fetch import APIResponse
     from playwright._impl._frame import Frame
-    from playwright._impl._page import Page
+    from playwright._impl._page import Page, Worker
 
 
 class FallbackOverrideParameters(TypedDict, total=False):
@@ -184,6 +184,13 @@ def url(self) -> str:
     def resource_type(self) -> str:
         return self._initializer["resourceType"]
 
+    @property
+    def service_worker(self) -> Optional["Worker"]:
+        return cast(
+            Optional["Worker"],
+            from_nullable_channel(self._initializer.get("serviceWorker")),
+        )
+
     @property
     def method(self) -> str:
         return cast(str, self._fallback_overrides.method or self._initializer["method"])
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 79210603c..469046b21 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -113,6 +113,24 @@ def resource_type(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.resource_type)
 
+    @property
+    def service_worker(self) -> typing.Optional["Worker"]:
+        """Request.service_worker
+
+        The Service `Worker` that is performing the request.
+
+        **Details**
+
+        This method is Chromium only. It's safe to call when using other browsers, but it will always be `null`.
+
+        Requests originated in a Service Worker do not have a `request.frame()` available.
+
+        Returns
+        -------
+        Union[Worker, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.service_worker)
+
     @property
     def method(self) -> str:
         """Request.method
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 0d892a0c9..82c7b983f 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -113,6 +113,24 @@ def resource_type(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.resource_type)
 
+    @property
+    def service_worker(self) -> typing.Optional["Worker"]:
+        """Request.service_worker
+
+        The Service `Worker` that is performing the request.
+
+        **Details**
+
+        This method is Chromium only. It's safe to call when using other browsers, but it will always be `null`.
+
+        Requests originated in a Service Worker do not have a `request.frame()` available.
+
+        Returns
+        -------
+        Union[Worker, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.service_worker)
+
     @property
     def method(self) -> str:
         """Request.method
diff --git a/setup.py b/setup.py
index a0a51c3e4..fa81e5e85 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.57.0"
+driver_version = "1.57.0-beta-1764944708000"
 
 base_wheel_bundles = [
     {
diff --git a/tests/sync/test_network.py b/tests/sync/test_network.py
index 9ba91c431..8c196affb 100644
--- a/tests/sync/test_network.py
+++ b/tests/sync/test_network.py
@@ -92,7 +92,7 @@ def handle_request(route: Route) -> None:
     assert response.json() == {"foo": "bar"}
 
 
-def test_should_report_if_request_was_from_service_worker(
+def test_should_report_if_response_was_from_service_worker(
     page: Page, server: Server
 ) -> None:
     response = page.goto(server.PREFIX + "/serviceworkers/fetch/sw.html")
@@ -102,3 +102,15 @@ def test_should_report_if_request_was_from_service_worker(
     with page.expect_response("**/example.txt") as response_info:
         page.evaluate("() => fetch('/example.txt')")
     assert response_info.value.from_service_worker
+
+
+@pytest.mark.only_browser("chromium")
+def test_should_report_service_worker_request(page: Page, server: Server) -> None:
+    with page.context.expect_event("serviceworker") as worker_info:
+        page.goto(server.PREFIX + "/serviceworkers/fetch/sw.html")
+        page.evaluate("() => window.activationPromise")
+    with page.context.expect_event(
+        "request", lambda r: r.service_worker is not None
+    ) as request_info:
+        page.evaluate("() => fetch('/example.txt')")
+    assert request_info.value.service_worker == worker_info.value

From d3f5438d53dc10657ec8c5859049069b3b3b281a Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Mon, 8 Dec 2025 11:31:56 +0100
Subject: [PATCH 04/13] chore: throw FileNotFoundError for nonexistant files
 (#3014)

---
 playwright/_impl/_set_input_files_helpers.py | 4 +++-
 tests/sync/test_locators.py                  | 6 ++++++
 2 files changed, 9 insertions(+), 1 deletion(-)

diff --git a/playwright/_impl/_set_input_files_helpers.py b/playwright/_impl/_set_input_files_helpers.py
index 0f40d5b99..65307e0a2 100644
--- a/playwright/_impl/_set_input_files_helpers.py
+++ b/playwright/_impl/_set_input_files_helpers.py
@@ -14,6 +14,7 @@
 import base64
 import collections.abc
 import os
+import stat
 from pathlib import Path
 from typing import (
     TYPE_CHECKING,
@@ -144,7 +145,8 @@ def resolve_paths_and_directory_for_input_files(
     local_paths: Optional[List[str]] = None
     local_directory: Optional[str] = None
     for item in items:
-        if os.path.isdir(item):
+        item_stat = os.stat(item)  # Raises FileNotFoundError if doesn't exist
+        if stat.S_ISDIR(item_stat.st_mode):
             if local_directory:
                 raise Error("Multiple directories are not supported")
             local_directory = str(Path(item).resolve())
diff --git a/tests/sync/test_locators.py b/tests/sync/test_locators.py
index b554f0544..49d4d46ae 100644
--- a/tests/sync/test_locators.py
+++ b/tests/sync/test_locators.py
@@ -327,6 +327,12 @@ def test_locators_should_upload_a_file(page: Page, server: Server) -> None:
     )
 
 
+def test_locators_upload_nonexistant_file(page: Page, server: Server) -> None:
+    page.goto(server.PREFIX + "/input/fileupload.html")
+    with pytest.raises(FileNotFoundError):
+        page.locator("input[type=file]").set_input_files("nonexistant.html")
+
+
 def test_locators_should_press(page: Page) -> None:
     page.set_content("<input type='text' />")
     page.locator("input").press("h")

From 47a5d35ef4f815a2021349f86ae391f7c20c02d6 Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Fri, 30 Jan 2026 14:39:39 +0100
Subject: [PATCH 05/13] chore: roll to 1.58.0 (#3026)

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
---
 .claude/skills/playwright-roll/SKILL.md | 23 ++++++++++++++
 README.md                               |  4 +--
 playwright/_impl/_browser_type.py       |  3 +-
 playwright/_impl/_console_message.py    |  1 +
 playwright/async_api/_generated.py      | 40 +++++++++++--------------
 playwright/sync_api/_generated.py       | 40 +++++++++++--------------
 setup.py                                |  2 +-
 tests/async/test_expect_misc.py         |  2 +-
 tests/async/test_worker.py              |  6 ++--
 tests/sync/test_expect_misc.py          |  2 +-
 10 files changed, 68 insertions(+), 55 deletions(-)
 create mode 100644 .claude/skills/playwright-roll/SKILL.md

diff --git a/.claude/skills/playwright-roll/SKILL.md b/.claude/skills/playwright-roll/SKILL.md
new file mode 100644
index 000000000..ece920353
--- /dev/null
+++ b/.claude/skills/playwright-roll/SKILL.md
@@ -0,0 +1,23 @@
+---
+name: playwright-roll
+description: Roll Playwright Python to a new version
+---
+
+Help the user roll to a new version of Playwright.
+../../../ROLLING.md contains general instructions and scripts.
+
+Start with updating the version and generating the API to see the state of things.
+
+Afterwards, work through the list of changes that need to be backported.
+You can find a list of pull requests that might need to be taking into account in the issue titled "Backport changes".
+Work through them one-by-one and check off the items that you have handled.
+Not all of them will be relevant, some might have partially been reverted, etc. - so feel free to check with the upstream release branch.
+
+Rolling includes:
+- updating client implementation to match changes in the upstream JS implementation (see ../playwright/packages/playwright-core/src/client)
+- adding a couple of new tests to verify new/changed functionality
+
+## Tips & Tricks
+- Project checkouts are in the parent directory (`../`).
+- when updating checkboxes, store the issue content into /tmp and edit it there, then update the issue based on the file
+- use the "gh" cli to interact with GitHub
diff --git a/README.md b/README.md
index c1797dfe0..c5e2d70b0 100644
--- a/README.md
+++ b/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 -->143.0.7499.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->145.0.7632.6<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 | WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->144.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->146.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 93173160c..3aef7dd6d 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -82,7 +82,6 @@ async def launch(
         timeout: float = None,
         env: Env = None,
         headless: bool = None,
-        devtools: bool = None,
         proxy: ProxySettings = None,
         downloadsPath: Union[str, Path] = None,
         slowMo: float = None,
@@ -118,7 +117,6 @@ async def launch_persistent_context(
         timeout: float = None,
         env: Env = None,
         headless: bool = None,
-        devtools: bool = None,
         proxy: ProxySettings = None,
         downloadsPath: Union[str, Path] = None,
         slowMo: float = None,
@@ -200,6 +198,7 @@ async def connect_over_cdp(
         timeout: float = None,
         slowMo: float = None,
         headers: Dict[str, str] = None,
+        isLocal: bool = None,
     ) -> Browser:
         params = locals_to_params(locals())
         if params.get("headers"):
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index 7866df2ae..f37e3dd4d 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.py
@@ -57,6 +57,7 @@ def type(self) -> Union[
         Literal["startGroup"],
         Literal["startGroupCollapsed"],
         Literal["table"],
+        Literal["time"],
         Literal["timeEnd"],
         Literal["trace"],
         Literal["warning"],
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 469046b21..bd694886d 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -946,9 +946,12 @@ async def handle(route, request):
         `route.continue_()` will immediately send the request to the network, other matching handlers won't be
         invoked. Use `route.fallback()` If you want next matching handler in the chain to be invoked.
 
-        **NOTE** The `Cookie` header cannot be overridden using this method. If a value is provided, it will be ignored,
-        and the cookie will be loaded from the browser's cookie store. To set custom cookies, use
-        `browser_context.add_cookies()`.
+        **NOTE** Some request headers are **forbidden** and cannot be overridden (for example, `Cookie`, `Host`,
+        `Content-Length` and others, see
+        [this MDN page](https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_request_header) for full list). If an
+        override is provided for a forbidden header, it will be ignored and the original request header will be used.
+
+        To set custom cookies, use `browser_context.add_cookies()`.
 
         Parameters
         ----------
@@ -7039,6 +7042,7 @@ def type(
         Literal["startGroup"],
         Literal["startGroupCollapsed"],
         Literal["table"],
+        Literal["time"],
         Literal["timeEnd"],
         Literal["trace"],
         Literal["warning"],
@@ -7047,7 +7051,7 @@ def type(
 
         Returns
         -------
-        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "timeEnd", "trace", "warning"]
+        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "time", "timeEnd", "trace", "warning"]
         """
         return mapping.from_maybe_impl(self._impl_obj.type)
 
@@ -14440,7 +14444,6 @@ async def launch(
         timeout: typing.Optional[float] = None,
         env: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         headless: typing.Optional[bool] = None,
-        devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14514,12 +14517,7 @@ async def launch(
         headless : Union[bool, None]
             Whether to run browser in headless mode. More details for
             [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-            `devtools` option is `true`.
-        devtools : Union[bool, None]
-            **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-            `headless` option will be set `false`.
-            Deprecated: Use [debugging tools](../debug.md) instead.
+            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings.
         downloads_path : Union[pathlib.Path, str, None]
@@ -14557,7 +14555,6 @@ async def launch(
                 timeout=timeout,
                 env=mapping.to_impl(env),
                 headless=headless,
-                devtools=devtools,
                 proxy=proxy,
                 downloadsPath=downloads_path,
                 slowMo=slow_mo,
@@ -14583,7 +14580,6 @@ async def launch_persistent_context(
         timeout: typing.Optional[float] = None,
         env: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         headless: typing.Optional[bool] = None,
-        devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14691,12 +14687,7 @@ async def launch_persistent_context(
         headless : Union[bool, None]
             Whether to run browser in headless mode. More details for
             [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-            `devtools` option is `true`.
-        devtools : Union[bool, None]
-            **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-            `headless` option will be set `false`.
-            Deprecated: Use [debugging tools](../debug.md) instead.
+            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings.
         downloads_path : Union[pathlib.Path, str, None]
@@ -14858,7 +14849,6 @@ async def launch_persistent_context(
                 timeout=timeout,
                 env=mapping.to_impl(env),
                 headless=headless,
-                devtools=devtools,
                 proxy=proxy,
                 downloadsPath=downloads_path,
                 slowMo=slow_mo,
@@ -14908,6 +14898,7 @@ async def connect_over_cdp(
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
+        is_local: typing.Optional[bool] = None,
     ) -> "Browser":
         """BrowserType.connect_over_cdp
 
@@ -14942,6 +14933,9 @@ async def connect_over_cdp(
             on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with connect request. Optional.
+        is_local : Union[bool, None]
+            Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely
+            upon the file system being the same between Playwright and the Browser.
 
         Returns
         -------
@@ -14954,6 +14948,7 @@ async def connect_over_cdp(
                 timeout=timeout,
                 slowMo=slow_mo,
                 headers=mapping.to_impl(headers),
+                isLocal=is_local,
             )
         )
 
@@ -15397,8 +15392,7 @@ def description(self) -> typing.Optional[str]:
         """Locator.description
 
         Returns locator description previously set with `locator.describe()`. Returns `null` if no custom
-        description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the
-        description when available.
+        description has been set.
 
         **Usage**
 
@@ -19176,7 +19170,7 @@ async def to_contain_text(
         from playwright.async_api import expect
 
         # ✓ Contains the right items in the right order
-        await expect(page.locator(\"ul > li\")).to_contain_text([\"Text 1\", \"Text 3\", \"Text 4\"])
+        await expect(page.locator(\"ul > li\")).to_contain_text([\"Text 1\", \"Text 3\"])
 
         # ✖ Wrong order
         await expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 82c7b983f..0df2087df 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -960,9 +960,12 @@ def handle(route, request):
         `route.continue_()` will immediately send the request to the network, other matching handlers won't be
         invoked. Use `route.fallback()` If you want next matching handler in the chain to be invoked.
 
-        **NOTE** The `Cookie` header cannot be overridden using this method. If a value is provided, it will be ignored,
-        and the cookie will be loaded from the browser's cookie store. To set custom cookies, use
-        `browser_context.add_cookies()`.
+        **NOTE** Some request headers are **forbidden** and cannot be overridden (for example, `Cookie`, `Host`,
+        `Content-Length` and others, see
+        [this MDN page](https://developer.mozilla.org/en-US/docs/Glossary/Forbidden_request_header) for full list). If an
+        override is provided for a forbidden header, it will be ignored and the original request header will be used.
+
+        To set custom cookies, use `browser_context.add_cookies()`.
 
         Parameters
         ----------
@@ -7129,6 +7132,7 @@ def type(
         Literal["startGroup"],
         Literal["startGroupCollapsed"],
         Literal["table"],
+        Literal["time"],
         Literal["timeEnd"],
         Literal["trace"],
         Literal["warning"],
@@ -7137,7 +7141,7 @@ def type(
 
         Returns
         -------
-        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "timeEnd", "trace", "warning"]
+        Union["assert", "clear", "count", "debug", "dir", "dirxml", "endGroup", "error", "info", "log", "profile", "profileEnd", "startGroup", "startGroupCollapsed", "table", "time", "timeEnd", "trace", "warning"]
         """
         return mapping.from_maybe_impl(self._impl_obj.type)
 
@@ -14459,7 +14463,6 @@ def launch(
         timeout: typing.Optional[float] = None,
         env: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         headless: typing.Optional[bool] = None,
-        devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14533,12 +14536,7 @@ def launch(
         headless : Union[bool, None]
             Whether to run browser in headless mode. More details for
             [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-            `devtools` option is `true`.
-        devtools : Union[bool, None]
-            **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-            `headless` option will be set `false`.
-            Deprecated: Use [debugging tools](../debug.md) instead.
+            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings.
         downloads_path : Union[pathlib.Path, str, None]
@@ -14577,7 +14575,6 @@ def launch(
                     timeout=timeout,
                     env=mapping.to_impl(env),
                     headless=headless,
-                    devtools=devtools,
                     proxy=proxy,
                     downloadsPath=downloads_path,
                     slowMo=slow_mo,
@@ -14604,7 +14601,6 @@ def launch_persistent_context(
         timeout: typing.Optional[float] = None,
         env: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         headless: typing.Optional[bool] = None,
-        devtools: typing.Optional[bool] = None,
         proxy: typing.Optional[ProxySettings] = None,
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14712,12 +14708,7 @@ def launch_persistent_context(
         headless : Union[bool, None]
             Whether to run browser in headless mode. More details for
             [Chromium](https://developers.google.com/web/updates/2017/04/headless-chrome) and
-            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true` unless the
-            `devtools` option is `true`.
-        devtools : Union[bool, None]
-            **Chromium-only** Whether to auto-open a Developer Tools panel for each tab. If this option is `true`, the
-            `headless` option will be set `false`.
-            Deprecated: Use [debugging tools](../debug.md) instead.
+            [Firefox](https://hacks.mozilla.org/2017/12/using-headless-mode-in-firefox/). Defaults to `true`.
         proxy : Union[{server: str, bypass: Union[str, None], username: Union[str, None], password: Union[str, None]}, None]
             Network proxy settings.
         downloads_path : Union[pathlib.Path, str, None]
@@ -14880,7 +14871,6 @@ def launch_persistent_context(
                     timeout=timeout,
                     env=mapping.to_impl(env),
                     headless=headless,
-                    devtools=devtools,
                     proxy=proxy,
                     downloadsPath=downloads_path,
                     slowMo=slow_mo,
@@ -14931,6 +14921,7 @@ def connect_over_cdp(
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
+        is_local: typing.Optional[bool] = None,
     ) -> "Browser":
         """BrowserType.connect_over_cdp
 
@@ -14965,6 +14956,9 @@ def connect_over_cdp(
             on. Defaults to 0.
         headers : Union[Dict[str, str], None]
             Additional HTTP headers to be sent with connect request. Optional.
+        is_local : Union[bool, None]
+            Tells Playwright that it runs on the same host as the CDP server. It will enable certain optimizations that rely
+            upon the file system being the same between Playwright and the Browser.
 
         Returns
         -------
@@ -14978,6 +14972,7 @@ def connect_over_cdp(
                     timeout=timeout,
                     slowMo=slow_mo,
                     headers=mapping.to_impl(headers),
+                    isLocal=is_local,
                 )
             )
         )
@@ -15423,8 +15418,7 @@ def description(self) -> typing.Optional[str]:
         """Locator.description
 
         Returns locator description previously set with `locator.describe()`. Returns `null` if no custom
-        description has been set. Prefer `Locator.toString()` for a human-readable representation, as it uses the
-        description when available.
+        description has been set.
 
         **Usage**
 
@@ -19289,7 +19283,7 @@ def to_contain_text(
         from playwright.sync_api import expect
 
         # ✓ Contains the right items in the right order
-        expect(page.locator(\"ul > li\")).to_contain_text([\"Text 1\", \"Text 3\", \"Text 4\"])
+        expect(page.locator(\"ul > li\")).to_contain_text([\"Text 1\", \"Text 3\"])
 
         # ✖ Wrong order
         expect(page.locator(\"ul > li\")).to_contain_text([\"Text 3\", \"Text 2\"])
diff --git a/setup.py b/setup.py
index fa81e5e85..5a8229db1 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.57.0-beta-1764944708000"
+driver_version = "1.58.0"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_expect_misc.py b/tests/async/test_expect_misc.py
index 9c6a8aa01..2148b0d9e 100644
--- a/tests/async/test_expect_misc.py
+++ b/tests/async/test_expect_misc.py
@@ -58,7 +58,7 @@ async def test_to_be_in_viewport_should_have_good_stack(
     page: Page, server: Server
 ) -> None:
     with pytest.raises(AssertionError) as exc_info:
-        await expect(page.locator("body")).not_to_be_in_viewport(timeout=100)
+        await expect(page.locator("body")).not_to_be_in_viewport(timeout=1000)
     assert 'unexpected value "viewport ratio' in str(exc_info.value)
 
 
diff --git a/tests/async/test_worker.py b/tests/async/test_worker.py
index cd6828053..4c2e4ebeb 100644
--- a/tests/async/test_worker.py
+++ b/tests/async/test_worker.py
@@ -189,7 +189,7 @@ async def test_workers_should_report_network_activity_on_worker_creation(
 
 
 async def test_workers_should_format_number_using_context_locale(
-    browser: Browser, server: Server
+    browser: Browser, server: Server, browser_name: str
 ) -> None:
     context = await browser.new_context(locale="ru-RU")
     page = await context.new_page()
@@ -199,7 +199,9 @@ async def test_workers_should_format_number_using_context_locale(
             "() => new Worker(URL.createObjectURL(new Blob(['console.log(1)'], {type: 'application/javascript'})))"
         )
     worker = await worker_info.value
-    assert await worker.evaluate("() => (10000.20).toLocaleString()") == "10\u00a0000,2"
+    # https://github.com/microsoft/playwright/issues/38919
+    expected = "10,000.2" if browser_name == "firefox" else "10\u00a0000,2"
+    assert await worker.evaluate("() => (10000.20).toLocaleString()") == expected
     await context.close()
 
 
diff --git a/tests/sync/test_expect_misc.py b/tests/sync/test_expect_misc.py
index 042929fde..4d8b68cc0 100644
--- a/tests/sync/test_expect_misc.py
+++ b/tests/sync/test_expect_misc.py
@@ -56,7 +56,7 @@ def test_to_be_in_viewport_should_respect_ratio_option(
 
 def test_to_be_in_viewport_should_have_good_stack(page: Page, server: Server) -> None:
     with pytest.raises(AssertionError) as exc_info:
-        expect(page.locator("body")).not_to_be_in_viewport(timeout=100)
+        expect(page.locator("body")).not_to_be_in_viewport(timeout=1000)
     assert 'unexpected value "viewport ratio' in str(exc_info.value)
 
 

From 3aecfcfded4239d157bb3e86cb682f6c8ecf6827 Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Wed, 11 Feb 2026 13:58:01 +0100
Subject: [PATCH 06/13] fix: context.request timeout (#3032)

---
 playwright/_impl/_browser_context.py    |  1 +
 tests/sync/test_page_request_timeout.py | 36 +++++++++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 tests/sync/test_page_request_timeout.py

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index f56564a27..e27a9437a 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -124,6 +124,7 @@ def __init__(
         self._tracing = cast(Tracing, from_channel(initializer["tracing"]))
         self._har_recorders: Dict[str, HarRecordingMetadata] = {}
         self._request: APIRequestContext = from_channel(initializer["requestContext"])
+        self._request._timeout_settings = self._timeout_settings
         self._clock = Clock(self)
         self._channel.on(
             "bindingCall",
diff --git a/tests/sync/test_page_request_timeout.py b/tests/sync/test_page_request_timeout.py
new file mode 100644
index 000000000..8b65da26d
--- /dev/null
+++ b/tests/sync/test_page_request_timeout.py
@@ -0,0 +1,36 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import pytest
+
+from playwright.sync_api import BrowserContext, Error, Page
+from tests.server import Server
+
+
+def test_context_request_should_support_timeout_option(
+    page: Page, context: BrowserContext, server: Server
+) -> None:
+    # https://github.com/microsoft/playwright/issues/39220
+
+    server.set_route("/", lambda req: None)
+    with pytest.raises(Error, match="Timeout 123ms exceeded"):
+        page.request.get(server.PREFIX, timeout=123)
+    with pytest.raises(Error, match="Timeout 123ms exceeded"):
+        context.request.get(server.PREFIX, timeout=123)
+
+    context.set_default_timeout(123)
+    with pytest.raises(Error, match="Timeout 123ms exceeded"):
+        page.request.get(server.PREFIX)
+    with pytest.raises(Error, match="Timeout 123ms exceeded"):
+        context.request.get(server.PREFIX)

From 581316cb385f285dc3b07728982b5e730c0e2cca Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Tue, 28 Apr 2026 18:39:56 -0700
Subject: [PATCH 07/13] chore: roll to 1.59.1 (#3050)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .claude/skills/playwright-roll/SKILL.md       | 292 +++++++-
 .github/workflows/ci.yml                      |  11 +-
 .github/workflows/publish.yml                 |   4 +-
 CLAUDE.md                                     |  57 ++
 README.md                                     |   6 +-
 playwright/_impl/_api_structures.py           |  19 +
 playwright/_impl/_browser.py                  |  15 +
 playwright/_impl/_browser_context.py          |  18 +
 playwright/_impl/_browser_type.py             |   8 +-
 playwright/_impl/_cdp_session.py              |   8 +
 playwright/_impl/_console_message.py          |   4 +
 playwright/_impl/_debugger.py                 |  54 ++
 playwright/_impl/_dialog.py                   |  14 +-
 playwright/_impl/_local_utils.py              |   4 +-
 playwright/_impl/_locator.py                  |  15 +-
 playwright/_impl/_network.py                  |  12 +
 playwright/_impl/_object_factory.py           |   3 +
 playwright/_impl/_page.py                     |  73 +-
 playwright/_impl/_screencast.py               | 130 ++++
 playwright/_impl/_tracing.py                  |  16 +-
 playwright/_impl/_video.py                    |  41 +-
 playwright/async_api/__init__.py              |   8 +
 playwright/async_api/_generated.py            | 700 +++++++++++++++++-
 playwright/sync_api/__init__.py               |   8 +
 playwright/sync_api/_generated.py             | 658 +++++++++++++++-
 scripts/documentation_provider.py             |  32 +-
 scripts/generate_api.py                       |   8 +-
 setup.py                                      |   2 +-
 tests/async/test_browser.py                   |  14 +
 tests/async/test_browsercontext.py            |   7 +
 .../test_browsercontext_storage_state.py      |  26 +
 tests/async/test_click.py                     |  28 +-
 tests/async/test_debugger.py                  |  43 ++
 tests/async/test_dialog.py                    |  12 +
 tests/async/test_locators.py                  |   6 +
 tests/async/test_navigation.py                |   4 +-
 tests/async/test_page_aria_snapshot.py        |  17 +
 tests/async/test_page_event_console.py        |  32 +-
 tests/async/test_page_event_pageerror.py      |  24 +
 tests/async/test_page_network_request.py      |  21 +
 tests/async/test_page_network_response.py     |   7 +
 tests/async/test_popup.py                     |   6 +
 tests/async/test_route_web_socket.py          |  18 +-
 tests/async/test_screencast.py                |  72 ++
 tests/conftest.py                             |  20 +
 tests/sync/test_debugger.py                   |  20 +
 tests/sync/test_page_aria_snapshot.py         |  17 +
 tests/sync/test_page_event_console.py         |  13 +
 tests/sync/test_page_network_response.py      |   6 +
 tests/sync/test_route_web_socket.py           |  18 +-
 tests/sync/test_screencast.py                 |  53 ++
 51 files changed, 2506 insertions(+), 198 deletions(-)
 create mode 100644 CLAUDE.md
 create mode 100644 playwright/_impl/_debugger.py
 create mode 100644 playwright/_impl/_screencast.py
 create mode 100644 tests/async/test_debugger.py
 create mode 100644 tests/async/test_screencast.py
 create mode 100644 tests/sync/test_debugger.py
 create mode 100644 tests/sync/test_screencast.py

diff --git a/.claude/skills/playwright-roll/SKILL.md b/.claude/skills/playwright-roll/SKILL.md
index ece920353..9a6adbd03 100644
--- a/.claude/skills/playwright-roll/SKILL.md
+++ b/.claude/skills/playwright-roll/SKILL.md
@@ -1,23 +1,285 @@
 ---
 name: playwright-roll
-description: Roll Playwright Python to a new version
+description: Roll Playwright Python to a new driver version. Walks the upstream `docs/src/api/` commit range, ports each public-API change, suppresses the rest in `expected_api_mismatch.txt`, regenerates the typed surface, and adds tests.
 ---
 
-Help the user roll to a new version of Playwright.
-../../../ROLLING.md contains general instructions and scripts.
+# Rolling Playwright Python
 
-Start with updating the version and generating the API to see the state of things.
+The goal of a roll is to move `driver_version` in `setup.py` to a new release, port every public API change introduced upstream during that interval, and suppress the rest, so that `./scripts/update_api.sh` runs clean and the test suite still passes.
 
-Afterwards, work through the list of changes that need to be backported.
-You can find a list of pull requests that might need to be taking into account in the issue titled "Backport changes".
-Work through them one-by-one and check off the items that you have handled.
-Not all of them will be relevant, some might have partially been reverted, etc. - so feel free to check with the upstream release branch.
+The previous human-facing summary lives in `../../../ROLLING.md`. This skill is the operational playbook — read it end to end before starting.
 
-Rolling includes:
-- updating client implementation to match changes in the upstream JS implementation (see ../playwright/packages/playwright-core/src/client)
-- adding a couple of new tests to verify new/changed functionality
+## Mental model
 
-## Tips & Tricks
-- Project checkouts are in the parent directory (`../`).
-- when updating checkboxes, store the issue content into /tmp and edit it there, then update the issue based on the file
-- use the "gh" cli to interact with GitHub
+The Python port is hand-written code in `playwright/_impl/`, plus a generator (`scripts/generate_*.py`, `scripts/documentation_provider.py`) that:
+
+1. introspects the Python `_impl` classes via `inspect`,
+2. emits typed wrapper classes into `playwright/{async,sync}_api/_generated.py`, and
+3. diffs the introspected surface against `playwright/driver/package/api.json` (downloaded inside the new driver wheel).
+
+Anything in `api.json` that is missing or differently typed in `_impl/` causes generation to fail. Three resolutions:
+
+- **PORT** — the new API is intended for Python (no `langs.only` filter, or `langs.only` includes `"python"`). Implement it in `_impl/`.
+- **MISMATCH** — the API genuinely exists for Python but is shaped differently (a callback signature uses unions, a kwarg uses a legacy name, etc.) and there's a justified reason to keep the divergence. Add a precise line to `scripts/expected_api_mismatch.txt` with a comment explaining *why*.
+- **N/A** — the commit only touches docs, has `* langs: js` (or any other filter that excludes Python), is server-side, Electron-only, or was reverted later in the same release. No action.
+
+The upstream documentation source of truth is `docs/src/api/*.md` in the playwright repo. Every `## method:` / `## property:` / `## event:` / `### option:` / `### param:` block has an optional `* langs: js` (or `js, python`, etc.) filter. The Python doclint resolves these into `langs` fields on each member of `api.json`. **An empty `langs: {}` means "all languages including Python" — *implement it*, don't suppress it.**
+
+> **The mistake the 1.59 roll made twice over:** classifying things as "internal tooling, N/A for Python" based on the *name* of the API (Screencast, Debugger, pickLocator, clearConsoleMessages, artifactsDir, …). Almost all of those had empty `langs: {}` in `api.json` and were real Python APIs. Sounding tooling-y is not a `langs` filter. **The `langs` field on the member in `api.json` is the only authoritative signal.** When in doubt, dump it (see "Verifying classifications" below).
+
+## Pre-flight
+
+You will need two checkouts in the parent directory:
+- `~/code/playwright-python` — this repo.
+- `~/code/playwright` — the upstream playwright monorepo (used read-only for diffing).
+
+Bring upstream up to date and ensure release branches/tags are present:
+
+```sh
+git -C ~/code/playwright fetch --tags
+git -C ~/code/playwright fetch origin 'release-*:release-*'
+```
+
+There is sometimes no `vX.Y.0` tag for the latest release (the bots cut release branches first and tag later). Anchor on commits, not tags — see "Identify the commit range" below.
+
+## Process
+
+### 1. Set up the env
+
+`CONTRIBUTING.md` covers this. Notes from past rolls:
+
+- The repo says Python 3.9 is required, but 3.9+ works. If `python3.9` isn't available, use `python3` (3.12 is fine).
+- If `python3-venv` is missing system-wide, use `uv venv env` instead, then `uv pip install --python env/bin/python --upgrade pip`. Don't try to `apt install` — sudo is denied in the harness.
+- Always activate the venv before any `pip`, `pytest`, `mypy`, or `pre-commit` invocation.
+
+### 2. Bump the driver and download it
+
+```sh
+# Edit setup.py
+driver_version = "<new>"     # e.g. "1.59.1"
+
+source env/bin/activate
+python -m build --wheel       # downloads the new driver from cdn.playwright.dev
+playwright install chromium   # NOT --with-deps; sudo is denied
+```
+
+The wheel build prints `Fetching https://cdn.playwright.dev/builds/driver/playwright-<new>-linux.zip` and unpacks the driver under `playwright/driver/package/`. From this point, `playwright/driver/package/api.json` reflects the new release.
+
+### 3. Identify the commit range
+
+The diff range is "every commit on the new release branch since the previous release was cut". Anchor commits:
+
+- **Previous release end**: the `chore: bump version to vX.Y.0-next` commit on `main`. That commit is the first commit *after* the previous release (X.Y-1) was cut. Use its parent (`<sha>~1`) as the lower bound.
+  ```sh
+  git -C ~/code/playwright log --all --grep="bump version to v" --oneline | head
+  ```
+- **New release end**: the tip of `release-<new>` (or the matching tag if it exists).
+
+Save the commit list, oldest first, scoped to `docs/src/api/`:
+
+```sh
+git -C ~/code/playwright log <prev-anchor>~1..release-<new> --oneline --reverse -- docs/src/api > /tmp/roll-<new>-commits.md
+```
+
+A normal roll yields 50–100 commits. If you see 0 or thousands, the range is wrong.
+
+Format the file as a markdown checklist and add the standard preamble (status legend, where to look up `api.json` etc.) — see the file from the 1.58→1.59 roll for the template.
+
+### 4. Walk the commit list
+
+For each commit, in chronological order:
+
+```sh
+git -C ~/code/playwright show <sha> -- docs/src/api/
+```
+
+Look for:
+- `## (async )?method:` / `## property:` / `## event:` additions or removals;
+- `* langs: ...` lines on those blocks;
+- `### param:` / `### option:` additions or removals;
+- new `class-X.md` files (whole new classes — usually `langs: js`);
+- type changes in `- returns:` lines.
+
+Classify and act.
+
+#### Verifying classifications (do this before suppressing anything)
+
+Before tagging anything as MISMATCH or N/A based on appearance, dump the actual `langs` from `api.json`:
+
+```python
+import json
+data = json.load(open("playwright/driver/package/api.json"))
+classes = {c["name"]: c for c in data}
+for cls_name in ["Page", "BrowserContext", "Screencast", "Debugger"]:
+    cls = classes.get(cls_name)
+    if not cls:
+        continue
+    print(f"\n{cls_name}: cls_langs={cls.get('langs', {})}")
+    for m in cls["members"]:
+        print(f"  {m['name']} kind={m.get('kind')} langs={m.get('langs', {})}")
+```
+
+For options/params nested inside an `Object`-typed arg, walk one level deeper:
+
+```python
+for a in member.get("args", []):
+    if a["name"] == "options":
+        for prop in a.get("type", {}).get("properties", []):
+            print(prop["name"], prop.get("langs", {}))
+```
+
+A few rules of thumb that catch most "actually a PORT" cases:
+- If the *containing class* has empty `langs: {}` and the *member* has empty `langs: {}`, it's for Python — implement it.
+- If the member is empty but a single *option* has `langs: js`, the method is for Python and you only skip that option (e.g. `Screencast.start.size` is `langs: js` while `Screencast.start` itself isn't).
+- If you're about to add three or more `Method not implemented:` entries for the same class, stop — you almost certainly need to implement the class.
+
+#### PORT
+
+Implement the change in `playwright/_impl/<module>.py`. Use the upstream JS implementation as a reference: `~/code/playwright/packages/playwright-core/src/client/<module>.ts`. Translate idioms:
+
+| Upstream JS | Python |
+|---|---|
+| `async foo(): Promise<X>` | `async def foo(self) -> X:` |
+| `foo(): X` (sync getter, no args, no body) | `@property def foo(self) -> X:` (the doc generator treats argument-less sync getters as properties — see `documentation_provider.py:133`. If you make it a method instead, you'll get a "Method vs property mismatch" error.) |
+| `await this._channel.foo({ a, b })` | `await self._channel.send("foo", None, locals_to_params(locals()))` |
+| `(await this._channel.foo()).value` | `await self._channel.send("foo", None)` (Python's `send()` auto-unwraps single-key responses; only call `send_return_as_dict` when the protocol returns multiple keys.) |
+| `(await this._channel.foo()).artifact` (multi-key, may be empty) | `result = await self._channel.send_return_as_dict("foo", None); (result or {}).get("artifact")` — `send_return_as_dict` returns **`None`** (not `{}`) when the protocol response carries no fields. |
+| `try { ... } catch (e) { if (isTargetClosedError(e)) return; throw e; }` | `try: ...; except Exception as e: if is_target_closed_error(e): return; raise` (import from `playwright._impl._errors`) |
+| Inline `[Object]` return like `{endpoint: string}` | A `TypedDict` in `playwright/_impl/_api_structures.py` — *not* `Dict[str, str]`. The doc generator serializes TypedDicts as `{field: type, ...}` via `get_type_hints` and that matches the inline-object form exactly. See `RemoteAddr`, `BrowserBindResult`, `DebuggerPausedDetails`. |
+| `binary` event/return field | The Python channel layer hands you a base64 string. Decode with `base64.b64decode(value)` before exposing as `bytes`. See `Screencast._dispatch_frame`. |
+
+When implementing a new ChannelOwner subclass (one constructed by the protocol with `(parent, type, guid, initializer)`):
+1. Register it in `playwright/_impl/_object_factory.py:create_remote_object` — otherwise the guid resolves to `DummyObject` and downstream code breaks mysteriously.
+2. Import it and add it to `generated_types` in `scripts/generate_api.py`, plus add a `XxxImpl` import in the `header` string.
+
+When implementing a non-ChannelOwner wrapper class (a plain class that holds a Page/Context reference, like `Screencast`, `Clock`):
+- Set `self._loop = parent._loop` and `self._dispatcher_fiber = parent._dispatcher_fiber` in `__init__`. The generated `AsyncBase`/`SyncBase` wrappers read these; missing them gives `AttributeError: 'X' object has no attribute '_loop'` at first use.
+
+When adding a new TypedDict in `_api_structures.py`:
+- Add it to the `from playwright._impl._api_structures import …` line in `scripts/generate_api.py` so the generator can resolve it as a forward reference in type hints.
+- Re-export it from both `playwright/async_api/__init__.py` and `playwright/sync_api/__init__.py`: assignment line plus an entry in `__all__`. Same pattern as `ViewportSize`, `RemoteAddr`.
+
+If the new API was previously suppressed in `expected_api_mismatch.txt`, **remove that line** when implementing it.
+
+If a doc rename involves a *positional* parameter (no default, before any `*`), users almost certainly call it positionally — you can rename freely. The 1.59 `BrowserType.connect.wsEndpoint` → `endpoint` is the canonical example. Don't suppress this kind of rename; just rename in `_impl/`. **Important corollary:** when docs rename a param, the wire-protocol field usually also changed in `packages/protocol/src/protocol.yml` and the server-side dispatcher in `packages/playwright-core/src/server/dispatchers/*Dispatcher.ts`. If so, you must also update the channel-send dict key (e.g. `{"wsEndpoint": …}` → `{"endpoint": …}`). A "Parameter not documented" suppression for a renamed param is a code smell hiding a wire-protocol bug.
+
+#### MISMATCH
+
+A MISMATCH is a *justified, durable* divergence between the docs and the Python surface. Use it sparingly — most apparent mismatches turn out to be PORTs you skipped. Legitimate examples in the current `expected_api_mismatch.txt`:
+
+- Hidden internal kwargs (`Browser.new_context(default_browser_type=)`).
+- Callback signatures where Python explicitly unions one-arg and two-arg variants but the docs document only the canonical form (`Page.route(handler=)`, `WebSocketRoute.on_close(handler=)`).
+
+Add a precise line to `scripts/expected_api_mismatch.txt` with a `# comment` group header explaining *why* the divergence is intentional. The exact wording comes from the generator's error message. Examples:
+
+```
+# One vs two arguments in the callback, Python explicitly unions.
+Parameter type mismatch in Page.route(handler=): documented as Callable[[Route, Request], Union[Any, Any]], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
+```
+
+The generator removes lines from `expected_api_mismatch.txt` that no longer match an error. If you see "No longer there: …" in the script's stderr, delete that line.
+
+**Do not suppress** these — they're PORTs in disguise:
+
+- "Internal tooling" classes/methods whose `langs` field is empty (`Screencast.*`, `Debugger.*`, `Page.pick_locator`, `BrowserContext.debugger`, `Browser.bind/unbind`, `Page.{clear,console}_*`). The 1.59 roll suppressed all of these initially, then had to walk every one back. Verify `langs` first.
+- A renamed positional parameter (`Parameter not documented: X.y(old_name=)` + `Parameter not implemented: X.y(new_name=)`). Just rename in `_impl/` and update the channel-send dict key.
+- A `Parameter type mismatch in X.y(return=): documented as {field: T}, code has Dict[str, T]`. Use a TypedDict.
+
+#### N/A
+
+Common N/A flavors:
+- Whole new class with `langs: js` (Disposable, Inspector/Screencast, Debugger, Overlay).
+- Members with `langs: js` (most "tooling" / MCP / agentic features).
+- Doc-only edits (typo fixes, "Improve `not` property sections", etc.).
+- Reverts that cancel an earlier add in the same range (always check the rest of the range before porting something that gets reverted).
+- Java/C# `langs:` blocks.
+- Electron-only changes (`docs/src/api/class-electron.md`).
+
+Tick the box in `/tmp/roll-<new>-commits.md` with one line: `[x] <sha> <subject> — <classification>: <one-liner>`.
+
+### 5. Regenerate
+
+```sh
+./scripts/update_api.sh
+```
+
+The script does, in order:
+1. `git checkout HEAD -- playwright/{async,sync}_api/_generated.py` (resets to last committed),
+2. runs `scripts/generate_{sync,async}_api.py` which dumps to `.x` then renames into place,
+3. invokes `pre-commit run --files` on the generated files.
+
+Failure modes and fixes:
+
+| Symptom | Cause | Fix |
+|---|---|---|
+| `Method not implemented: X.y` | `api.json` documents `X.y`, no Python impl exists. | PORT it, or add a MISMATCH line. |
+| `Parameter not implemented: X.y(z=)` | New parameter on existing method. | Add the kwarg in `_impl/`, or MISMATCH. |
+| `Method vs property mismatch: X.y` | You implemented as a method but the doc treats it as a property (sync, no args, has return type). | Add `@property` in `_impl/`. |
+| `Method not documented: X.y` | Python has it but `api.json` doesn't. | The upstream removed the API; remove from `_impl/` and from `_generated.py` callers. |
+| `Parameter type mismatch in X.y(z=): documented as ..., code has ...` | Type signature doesn't line up. | Match the type in `_impl/`, or MISMATCH it for known historical divergences. |
+| `pyright … reportInconsistentOverload` (single-event class) | A class gained its first event in `api.json`, so the generator emits one `Literal[…]` overload + impl, which pyright wants ≥2 of. | The generator already handles this — `documentation_provider.print_events` emits a second `@typing.overload` with `event: str` plus a generic impl. If you regress this, see how 1.59 handled `CDPSession` getting a `close` event. |
+| `pre-commit` keeps reformatting `_generated.py` on each run | First run after regen always reformats once; rerun until idle. | `pre-commit run --all-files` to settle. |
+| `Parameter not documented: X.y(z=)` | Python has a kwarg the docs don't mention (e.g. legacy name from a doc rename). | If the param is positional with no default, just rename it in `_impl/`. Check `protocol.yml` and the server dispatcher — if the wire field renamed too, also update the channel-send dict key. Only MISMATCH for genuinely hidden internal kwargs (`default_browser_type`). |
+| `KeyError: 'templates'` deep in `inner_serialize_doc_type` | A `Promise<X>\|X` union upstream collapsed to a bare `Promise` with no templates in `api.json`. | `documentation_provider.inner_serialize_doc_type` should treat that as `Any` (`if "templates" not in type: return "Any"`). |
+| `"void" is not defined (reportUndefinedVariable)` in generated event handlers | `api.json` has a `void`-typed event payload that the serializer left as the literal string `"void"`. | `documentation_provider.inner_serialize_doc_type` should map `"void"` to `"None"` alongside `"null"`. |
+| `AttributeError: 'X' object has no attribute '_loop'` (or `_dispatcher_fiber`) at first use of a new wrapper class | The non-ChannelOwner wrapper isn't initializing the fields the generated `AsyncBase`/`SyncBase` reads. | In the wrapper's `__init__`, set `self._loop = parent._loop` and `self._dispatcher_fiber = parent._dispatcher_fiber`. |
+| `'NoneType' object has no attribute 'get'` after `send_return_as_dict` | Method's protocol response carries no fields and `send_return_as_dict` returned `None`. | `(result or {}).get(...)`. |
+| Frame/buffer payload arrives as a `str` instead of `bytes` | Protocol `binary` fields cross the wire as base64. | `base64.b64decode(value)` in the impl before exposing. |
+
+After the script settles, run `pre-commit run --all-files` once more to confirm everything is idle.
+
+### 6. Add tests
+
+For each PORT, add one async test and a matching sync test. Conventions:
+
+- Tests go in the existing topic file (`test_page_network_request.py`, `test_browsercontext.py`, `test_dialog.py`, …) — don't create new files unless there's no obvious home.
+- Use `from playwright.async_api import …`, **not** `from playwright._impl._page import Page` (the impl class doesn't have the public wrappers like `expect_console_message`).
+- For event-info objects, `await message_info.value` (it's an `async` property).
+- Don't write tests that hang the page (e.g. `page.evaluate(... fetch slow ...)` followed by `page.close()` from a fixture) — the request task gets a `TargetClosedError`. Use `page.on("event", handler)` to capture state at event time instead.
+- `playwright install chromium` (no `--with-deps`) is sufficient for the test suite under sandbox.
+
+### 7. Update existing high-touch artifacts
+
+- `setup.py`: already done in step 2.
+- `README.md`: gets the chromium/firefox/webkit version table updated automatically by `scripts/update_versions.py` (called from `update_api.sh`). Don't edit by hand.
+- The "Backport changes" tracking issue on GitHub (filed by `microsoft-playwright-automation`) is the *intent* tracker, but it's frequently out of sync with what's actually been ported. Treat it as a starting point, not the source of truth — the `docs/src/api/` commit walk is authoritative.
+
+### 8. Final verification
+
+```sh
+pre-commit run --all-files
+mypy playwright                 # 2 pre-existing errors in _json_pipe.py and _artifact.py are unrelated
+pytest --browser chromium tests/async/<files-you-touched> tests/sync/<files-you-touched>
+```
+
+Then a smoke regression on a few neighboring suites (`tests/async/test_browser*.py`, `test_cdp_session.py`, `test_tracing.py`, `test_dialog.py`, `test_page_*.py`) to make sure nothing inherent to the port shifted.
+
+## Reference: `expected_api_mismatch.txt` line forms
+
+Exact strings the generator emits (and that this file must contain to suppress):
+
+```
+Method not implemented: <Class>.<snake_method>
+Parameter not implemented: <Class>.<snake_method>(<snake_param>=)
+Parameter not documented: <Class>.<snake_method>(<snake_param>=)
+Method vs property mismatch: <Class>.<snake_method>
+Method not documented: <Class>.<snake_method>
+Parameter type mismatch in <Class>.<snake_method>(<arg>=): documented as <T1>, code has <T2>
+```
+
+Class names use the upstream PascalCase (`BrowserContext`, `BrowserType`); method/param names are converted to `snake_case` matching the Python surface.
+
+## Tips & gotchas
+
+- **`langs.only` is your filter — and the only filter.** Don't classify by name (`Screencast`, `Debugger`, `pickLocator`) or by intuition ("looks like internal tooling"). Always check `langs` in `api.json`. The 1.59 roll cost two extra audit passes by trusting names over `langs`.
+- **Audit your own classifications a second time.** After the first walk through the commit range, before opening the PR, re-read every line in `expected_api_mismatch.txt` you added during this roll and ask "is this divergence justified, or did I skip a port?" Run the `langs`-dump snippet on each suspicious entry. The 1.59 roll's first PR had ~20 wrong suppressions; the second pass cut them to 0.
+- **A cluster of suppressions on the same class is a smell.** If you're about to add five `Method not implemented: Foo.*` lines, you're almost certainly looking at a class that needs to be implemented. Implement the whole thing once and the suppressions disappear.
+- **Watch for revert pairs in the same range.** 1.59 added and reverted `Browser.isRemote` (#39613 / #39620) inside the same release. Walking chronologically lets you skip the add when you see the revert later.
+- **Watch for rename-revert pairs.** 1.59 had `Locator.normalize` → `Locator.toCode` (#39648) → `Locator.normalize` (#39754). Final state wins; only port the last.
+- **Doc renames almost always include a wire-protocol rename.** Whenever you see `### param: X.y.oldName` → `### param: X.y.newName` in a doc commit, also `git -C ~/code/playwright show <sha> -- packages/protocol/src/protocol.yml` and the corresponding `*Dispatcher.ts` file. If the wire field changed too, the channel-send dict key in `_impl/` must change. Suppressing the doc-side mismatch is hiding a real bug — the previous Python code is silently sending an unknown field that the new server ignores.
+- **TypedDicts beat `Dict[str, X]` for any structured return.** When the docs describe a return as `[Object]` with named fields (or even `[Object=Foo]`), define a `TypedDict` in `_api_structures.py`, re-export from both public `__init__.py` files, and use it. Zero runtime cost (it's still a `dict`), and the doc generator's type comparator matches by structure via `get_type_hints`.
+- **Positional renames are free.** A param with no default before any `*` separator is positional-or-keyword in Python, but realistic call sites pass it positionally. Renaming such a param doesn't break callers.
+- **The "Backport changes" GitHub issue can be misleading.** In the 1.59 roll its checkboxes were all marked `[x]` with annotations like "✅ IMPLEMENTED", but several of those features had not actually been merged into the Python port. Trust the `docs/src/api/` walk over the issue.
+- **`api.json` may carry doclint quirks.** 1.59 hit two: `Promise<X>|X` collapsed to a bare `Promise` with no `templates`, and `void`-typed events serialized as the literal string `"void"`. Both are upstream artifacts; patch `inner_serialize_doc_type` to handle them rather than fighting the api.json side.
+- **Don't edit `_generated.py` to fix lint or typing.** Fix `_impl/`, `documentation_provider.py`, or `expected_api_mismatch.txt` instead. Hand-editing the generated file is reverted on the next regen.
+- **`/tmp/roll-<new>-commits.md` is a working artifact, not a deliverable.** Don't commit it. The commit message and PR description are where the audit summary belongs.
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 65ba1f433..ecb593832 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -162,6 +162,13 @@ jobs:
       matrix:
         os: [ubuntu-22.04, macos-13, windows-2022]
     runs-on: ${{ matrix.os }}
+    defaults:
+      run:
+        # `setup-miniconda` activates the env only for login shells; using
+        # `bash -el` (recommended by the action) ensures `conda` and the
+        # installed `conda-build` are on PATH on every OS, including Windows
+        # where the default shell is pwsh and skips the activation hooks.
+        shell: bash -el {0}
     steps:
       - uses: actions/checkout@v5
         with:
@@ -169,11 +176,11 @@ jobs:
       - name: Get conda
         uses: conda-incubator/setup-miniconda@v3
         with:
-          python-version: 3.9
+          python-version: '3.12'
           channels: conda-forge
           miniconda-version: latest
       - name: Prepare
-        run: conda install conda-build conda-verify
+        run: conda install -n base "conda-build>=26" conda-verify
       - name: Build
         run: conda build .
 
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index c6e71028a..e9a7048c5 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -31,11 +31,11 @@ jobs:
       - name: Get conda
         uses: conda-incubator/setup-miniconda@v3
         with:
-          python-version: 3.9
+          python-version: '3.12'
           channels: conda-forge
           miniconda-version: latest
       - name: Prepare
-        run: conda install anaconda-client conda-build conda-verify
+        run: conda install -n base anaconda-client "conda-build>=26" conda-verify
       - name: Build and Upload
         env:
           ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..ce4ec7c07
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+Guidance for Claude when working in this repository.
+
+## What this is
+
+Python bindings for [Playwright](https://playwright.dev). The Python client talks JSON over a pipe to the Node-based driver bundled in `playwright/driver/`. The pipe protocol is defined upstream in `packages/protocol/src/protocol.yml`.
+
+## Layout
+
+- `playwright/_impl/` — hand-written client implementation (one module per object: `_browser.py`, `_page.py`, `_locator.py`, `_network.py`, etc.). Edit these to add or change behavior.
+- `playwright/async_api/_generated.py`, `playwright/sync_api/_generated.py` — **auto-generated**. Never edit by hand; rerun `./scripts/update_api.sh` after changing `_impl/` or the driver.
+- `scripts/generate_api.py`, `scripts/generate_async_api.py`, `scripts/generate_sync_api.py`, `scripts/documentation_provider.py` — codegen and validation. They diff the Python implementation against the driver's `playwright/driver/package/api.json` and abort if either side is out of sync.
+- `scripts/expected_api_mismatch.txt` — explicit allowlist of "documented in JS, not in Python" or "named differently in Python" gaps. Lines that no longer apply must be removed.
+- `tests/async/`, `tests/sync/` — pytest suites. Most new tests are added to the async file with a sync mirror.
+- `setup.py` — `driver_version = "X.Y.Z"` is the source of truth for which driver build is downloaded from `cdn.playwright.dev`.
+- `ROLLING.md`, `CONTRIBUTING.md` — human-facing setup and roll docs.
+
+## Setup
+
+`CONTRIBUTING.md` has the full sequence. The short version:
+
+```sh
+python3 -m venv env && source env/bin/activate
+pip install --upgrade pip
+pip install -r local-requirements.txt
+pip install -e .
+python -m build --wheel        # downloads the driver listed in setup.py
+pre-commit install
+```
+
+If the system lacks `python3-venv`, `uv venv env` is an acceptable substitute (then `uv pip install --python env/bin/python --upgrade pip`).
+
+## Common commands
+
+- Regenerate `_generated.py`: `./scripts/update_api.sh` (runs codegen + pre-commit on the generated files).
+- Lint everything: `pre-commit run --all-files`.
+- Type-check: `mypy playwright`.
+- Run tests: `pytest --browser chromium [-k name]`. Browsers are installed via `playwright install chromium` (do **not** use `--with-deps`, which requires sudo).
+
+When changing public API, edit `_impl/`, then run `./scripts/update_api.sh`. The script regenerates `_generated.py` and validates against the driver's `api.json`. If validation fails, fix the mismatch in `_impl/`, in `expected_api_mismatch.txt`, or in `documentation_provider.py` — not by hand-editing `_generated.py`.
+
+## Rolling Playwright to a new version
+
+This is the recurring high-stakes task. Use the dedicated skill:
+
+→ **[`.claude/skills/playwright-roll/SKILL.md`](.claude/skills/playwright-roll/SKILL.md)**
+
+It documents the full process: the upstream commit-range diff over `docs/src/api/`, how to classify each commit (PORT / MISMATCH / N/A), how to handle the `langs:` filter, the recurring failure modes, and the tests/sync-mirroring conventions.
+
+## House style
+
+- Don't hand-edit generated files.
+- Don't add `# type: ignore` or modify `_generated.py` to silence pyright; fix the source of the mismatch.
+- New public methods on impl classes need a sync test mirror under `tests/sync/`.
+- Keep `expected_api_mismatch.txt` minimal — every entry needs a one-line rationale comment above it.
+- Prefer `locals_to_params(locals())` for forwarding optional kwargs to channel sends, matching the rest of the codebase.
diff --git a/README.md b/README.md
index c5e2d70b0..f0a4fc423 100644
--- a/README.md
+++ b/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 -->145.0.7632.6<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | ✅ | ✅ | ✅ |
-| Firefox <!-- GEN:firefox-version -->146.0.1<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Chromium <!-- GEN:chromium-version -->147.0.7727.15<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| WebKit <!-- GEN:webkit-version -->26.4<!-- GEN:stop --> | ✅ | ✅ | ✅ |
+| Firefox <!-- GEN:firefox-version -->148.0.2<!-- GEN:stop --> | ✅ | ✅ | ✅ |
 
 ## Documentation
 
diff --git a/playwright/_impl/_api_structures.py b/playwright/_impl/_api_structures.py
index c0d0ee442..256b59435 100644
--- a/playwright/_impl/_api_structures.py
+++ b/playwright/_impl/_api_structures.py
@@ -166,6 +166,10 @@ class RemoteAddr(TypedDict):
     port: int
 
 
+class BrowserBindResult(TypedDict):
+    endpoint: str
+
+
 class SecurityDetails(TypedDict):
     issuer: Optional[str]
     protocol: Optional[str]
@@ -311,3 +315,18 @@ class TracingGroupLocation(TypedDict):
     file: str
     line: Optional[int]
     column: Optional[int]
+
+
+class DebuggerLocation(TypedDict):
+    file: str
+    line: Optional[int]
+    column: Optional[int]
+
+
+class DebuggerPausedDetails(TypedDict):
+    location: DebuggerLocation
+    title: str
+
+
+class ScreencastFrame(TypedDict):
+    data: bytes
diff --git a/playwright/_impl/_browser.py b/playwright/_impl/_browser.py
index 5a9a87450..6454f8c3f 100644
--- a/playwright/_impl/_browser.py
+++ b/playwright/_impl/_browser.py
@@ -27,6 +27,7 @@
 )
 
 from playwright._impl._api_structures import (
+    BrowserBindResult,
     ClientCertificate,
     Geolocation,
     HttpCredentials,
@@ -247,6 +248,20 @@ def version(self) -> str:
     async def new_browser_cdp_session(self) -> CDPSession:
         return from_channel(await self._channel.send("newBrowserCDPSession", None))
 
+    async def bind(
+        self,
+        title: str,
+        workspaceDir: str = None,
+        host: str = None,
+        port: int = None,
+    ) -> BrowserBindResult:
+        return await self._channel.send_return_as_dict(
+            "startServer", None, locals_to_params(locals())
+        )
+
+    async def unbind(self) -> None:
+        await self._channel.send("stopServer", None)
+
     async def start_tracing(
         self,
         page: Page = None,
diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index e27a9437a..4b1c19c40 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -46,6 +46,7 @@
     from_nullable_channel,
 )
 from playwright._impl._console_message import ConsoleMessage
+from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
 from playwright._impl._errors import Error, TargetClosedError
 from playwright._impl._event_context_manager import EventContextManagerImpl
@@ -122,6 +123,7 @@ def __init__(
         self._base_url: Optional[str] = self._options.get("baseURL")
         self._videos_dir: Optional[str] = self._options.get("recordVideo")
         self._tracing = cast(Tracing, from_channel(initializer["tracing"]))
+        self._debugger: Debugger = cast(Debugger, from_channel(initializer["debugger"]))
         self._har_recorders: Dict[str, HarRecordingMetadata] = {}
         self._request: APIRequestContext = from_channel(initializer["requestContext"])
         self._request._timeout_settings = self._timeout_settings
@@ -582,6 +584,9 @@ def _on_close(self) -> None:
         self._tracing._reset_stack_counter()
         self.emit(BrowserContext.Events.Close, self)
 
+    def is_closed(self) -> bool:
+        return self._closing_or_closed
+
     async def close(self, reason: str = None) -> None:
         if self._closing_or_closed:
             return
@@ -627,6 +632,15 @@ async def storage_state(
             await async_writefile(path, json.dumps(result))
         return result
 
+    async def set_storage_state(
+        self, storageState: Union[StorageState, str, Path]
+    ) -> None:
+        if isinstance(storageState, (str, Path)):
+            state = json.loads(await async_readfile(storageState))
+        else:
+            state = storageState
+        await self._channel.send("setStorageState", None, {"storageState": state})
+
     def _effective_close_reason(self) -> Optional[str]:
         if self._close_reason:
             return self._close_reason
@@ -753,6 +767,10 @@ async def new_cdp_session(self, page: Union[Page, Frame]) -> CDPSession:
     def tracing(self) -> Tracing:
         return self._tracing
 
+    @property
+    def debugger(self) -> Debugger:
+        return self._debugger
+
     @property
     def request(self) -> "APIRequestContext":
         return self._request
diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index 3aef7dd6d..ba376c336 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -86,6 +86,7 @@ async def launch(
         downloadsPath: Union[str, Path] = None,
         slowMo: float = None,
         tracesDir: Union[pathlib.Path, str] = None,
+        artifactsDir: Union[pathlib.Path, str] = None,
         chromiumSandbox: bool = None,
         firefoxUserPrefs: Dict[str, Union[str, float, bool]] = None,
     ) -> Browser:
@@ -143,6 +144,7 @@ async def launch_persistent_context(
         contrast: Contrast = None,
         acceptDownloads: bool = None,
         tracesDir: Union[pathlib.Path, str] = None,
+        artifactsDir: Union[pathlib.Path, str] = None,
         chromiumSandbox: bool = None,
         firefoxUserPrefs: Dict[str, Union[str, float, bool]] = None,
         recordHarPath: Union[Path, str] = None,
@@ -213,7 +215,7 @@ async def connect_over_cdp(
 
     async def connect(
         self,
-        wsEndpoint: str,
+        endpoint: str,
         timeout: float = None,
         slowMo: float = None,
         headers: Dict[str, str] = None,
@@ -229,7 +231,7 @@ async def connect(
                 "connect",
                 None,
                 {
-                    "wsEndpoint": wsEndpoint,
+                    "endpoint": endpoint,
                     "headers": headers,
                     "slowMo": slowMo,
                     "timeout": timeout if timeout is not None else 0,
@@ -361,3 +363,5 @@ def normalize_launch_params(params: Dict) -> None:
         params["downloadsPath"] = str(Path(params["downloadsPath"]))
     if "tracesDir" in params:
         params["tracesDir"] = str(Path(params["tracesDir"]))
+    if "artifactsDir" in params:
+        params["artifactsDir"] = str(Path(params["artifactsDir"]))
diff --git a/playwright/_impl/_cdp_session.py b/playwright/_impl/_cdp_session.py
index 95e65c57a..07d291ae2 100644
--- a/playwright/_impl/_cdp_session.py
+++ b/playwright/_impl/_cdp_session.py
@@ -12,6 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from types import SimpleNamespace
 from typing import Any, Dict
 
 from playwright._impl._connection import ChannelOwner
@@ -19,14 +20,21 @@
 
 
 class CDPSession(ChannelOwner):
+    Events = SimpleNamespace(
+        Event="event",
+        Close="close",
+    )
+
     def __init__(
         self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._channel.on("event", lambda params: self._on_event(params))
+        self._channel.on("close", lambda _: self.emit(CDPSession.Events.Close, self))
 
     def _on_event(self, params: Any) -> None:
         self.emit(params["method"], params.get("params"))
+        self.emit(CDPSession.Events.Event, params)
 
     async def send(self, method: str, params: Dict = None) -> Dict:
         return await self._channel.send("send", None, locals_to_params(locals()))
diff --git a/playwright/_impl/_console_message.py b/playwright/_impl/_console_message.py
index f37e3dd4d..d98901d34 100644
--- a/playwright/_impl/_console_message.py
+++ b/playwright/_impl/_console_message.py
@@ -76,6 +76,10 @@ def args(self) -> List[JSHandle]:
     def location(self) -> SourceLocation:
         return self._event["location"]
 
+    @property
+    def timestamp(self) -> float:
+        return self._event["timestamp"]
+
     @property
     def page(self) -> Optional["Page"]:
         return self._page
diff --git a/playwright/_impl/_debugger.py b/playwright/_impl/_debugger.py
new file mode 100644
index 000000000..36e4bd989
--- /dev/null
+++ b/playwright/_impl/_debugger.py
@@ -0,0 +1,54 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from types import SimpleNamespace
+from typing import Any, Dict, Optional
+
+from playwright._impl._api_structures import DebuggerLocation, DebuggerPausedDetails
+from playwright._impl._connection import ChannelOwner
+
+
+class Debugger(ChannelOwner):
+    Events = SimpleNamespace(
+        PausedStateChanged="pausedstatechanged",
+    )
+
+    def __init__(
+        self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
+    ) -> None:
+        super().__init__(parent, type, guid, initializer)
+        self._paused_details: Optional[DebuggerPausedDetails] = None
+        self._channel.on(
+            "pausedStateChanged", lambda params: self._on_paused_state_changed(params)
+        )
+
+    def _on_paused_state_changed(self, params: Dict[str, Any]) -> None:
+        self._paused_details = params.get("pausedDetails")
+        self.emit(Debugger.Events.PausedStateChanged)
+
+    async def request_pause(self) -> None:
+        await self._channel.send("requestPause", None)
+
+    async def resume(self) -> None:
+        await self._channel.send("resume", None)
+
+    async def next(self) -> None:
+        await self._channel.send("next", None)
+
+    async def run_to(self, location: DebuggerLocation) -> None:
+        await self._channel.send("runTo", None, {"location": location})
+
+    @property
+    def paused_details(self) -> Optional[DebuggerPausedDetails]:
+        return self._paused_details
diff --git a/playwright/_impl/_dialog.py b/playwright/_impl/_dialog.py
index 226e703b9..f6750e396 100644
--- a/playwright/_impl/_dialog.py
+++ b/playwright/_impl/_dialog.py
@@ -15,6 +15,7 @@
 from typing import TYPE_CHECKING, Dict, Optional
 
 from playwright._impl._connection import ChannelOwner, from_nullable_channel
+from playwright._impl._errors import is_target_closed_error
 from playwright._impl._helper import locals_to_params
 
 if TYPE_CHECKING:  # pragma: no cover
@@ -51,7 +52,12 @@ async def accept(self, promptText: str = None) -> None:
         await self._channel.send("accept", None, locals_to_params(locals()))
 
     async def dismiss(self) -> None:
-        await self._channel.send(
-            "dismiss",
-            None,
-        )
+        try:
+            await self._channel.send(
+                "dismiss",
+                None,
+            )
+        except Exception as e:
+            if is_target_closed_error(e):
+                return
+            raise
diff --git a/playwright/_impl/_local_utils.py b/playwright/_impl/_local_utils.py
index c2d2d3fca..cd8fd8343 100644
--- a/playwright/_impl/_local_utils.py
+++ b/playwright/_impl/_local_utils.py
@@ -62,7 +62,9 @@ async def har_unzip(self, zipFile: str, harFile: str) -> None:
         params = locals_to_params(locals())
         await self._channel.send("harUnzip", None, params)
 
-    async def tracing_started(self, tracesDir: Optional[str], traceName: str) -> str:
+    async def tracing_started(
+        self, tracesDir: Optional[str], traceName: str, live: bool = False
+    ) -> str:
         params = locals_to_params(locals())
         return await self._channel.send("tracingStarted", None, params)
 
diff --git a/playwright/_impl/_locator.py b/playwright/_impl/_locator.py
index 2e6a7abed..5f1b8f29a 100644
--- a/playwright/_impl/_locator.py
+++ b/playwright/_impl/_locator.py
@@ -564,7 +564,12 @@ async def screenshot(
             ),
         )
 
-    async def aria_snapshot(self, timeout: float = None) -> str:
+    async def aria_snapshot(
+        self,
+        timeout: float = None,
+        depth: int = None,
+        mode: Literal["ai", "default"] = None,
+    ) -> str:
         return await self._frame._channel.send(
             "ariaSnapshot",
             self._frame._timeout,
@@ -574,6 +579,14 @@ async def aria_snapshot(self, timeout: float = None) -> str:
             },
         )
 
+    async def normalize(self) -> "Locator":
+        result = await self._frame._channel.send(
+            "resolveSelector",
+            None,
+            {"selector": self._selector},
+        )
+        return Locator(self._frame, result)
+
     async def scroll_into_view_if_needed(
         self,
         timeout: float = None,
diff --git a/playwright/_impl/_network.py b/playwright/_impl/_network.py
index 9f2c29f6e..06bf88267 100644
--- a/playwright/_impl/_network.py
+++ b/playwright/_impl/_network.py
@@ -154,6 +154,7 @@ def __init__(
         self._fallback_overrides: SerializedFallbackOverrides = (
             SerializedFallbackOverrides()
         )
+        self._response: Optional["Response"] = None
 
     def __repr__(self) -> str:
         return f"<Request url={self.url!r} method={self.method!r}>"
@@ -243,6 +244,10 @@ async def response(self) -> Optional["Response"]:
             )
         )
 
+    @property
+    def existing_response(self) -> Optional["Response"]:
+        return self._response
+
     @property
     def frame(self) -> "Frame":
         if not self._initializer.get("frame"):
@@ -799,6 +804,7 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._request: Request = from_channel(self._initializer["request"])
+        self._request._response = self
         timing = self._initializer["timing"]
         self._request._timing["startTime"] = timing["startTime"]
         self._request._timing["domainLookupStart"] = timing["domainLookupStart"]
@@ -881,6 +887,12 @@ async def security_details(self) -> Optional[SecurityDetails]:
             None,
         )
 
+    async def http_version(self) -> str:
+        return await self._channel.send(
+            "httpVersion",
+            None,
+        )
+
     async def finished(self) -> None:
         async def on_finished() -> None:
             await self._request._target_closed_future()
diff --git a/playwright/_impl/_object_factory.py b/playwright/_impl/_object_factory.py
index b44009bc3..7abfb4b33 100644
--- a/playwright/_impl/_object_factory.py
+++ b/playwright/_impl/_object_factory.py
@@ -20,6 +20,7 @@
 from playwright._impl._browser_type import BrowserType
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._connection import ChannelOwner
+from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._fetch import APIRequestContext
@@ -64,6 +65,8 @@ def create_remote_object(
         return BrowserContext(parent, type, guid, initializer)
     if type == "CDPSession":
         return CDPSession(parent, type, guid, initializer)
+    if type == "Debugger":
+        return Debugger(parent, type, guid, initializer)
     if type == "Dialog":
         return Dialog(parent, type, guid, initializer)
     if type == "ElementHandle":
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 1f05a9048..4cecbd64c 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -98,6 +98,7 @@
     WebSocketRouteHandler,
     serialize_headers,
 )
+from playwright._impl._screencast import Screencast
 from playwright._impl._video import Video
 from playwright._impl._waiter import Waiter
 
@@ -175,7 +176,11 @@ def __init__(
         self._timeout_settings: TimeoutSettings = TimeoutSettings(
             self._browser_context._timeout_settings
         )
-        self._video: Optional[Video] = None
+        self._video: Video = Video(
+            self,
+            cast(Optional[Artifact], from_nullable_channel(initializer.get("video"))),
+        )
+        self._screencast: Screencast = Screencast(self)
         self._opener = cast("Page", from_nullable_channel(initializer.get("opener")))
         self._close_reason: Optional[str] = None
         self._close_was_called = False
@@ -224,7 +229,6 @@ def __init__(
                 self._on_web_socket_route(from_channel(params["webSocketRoute"]))
             ),
         )
-        self._channel.on("video", lambda params: self._on_video(params))
         self._channel.on("viewportSizeChanged", self._on_viewport_size_changed)
         self._channel.on(
             "webSocket",
@@ -356,10 +360,6 @@ def _on_download(self, params: Any) -> None:
             Page.Events.Download, Download(self, url, suggested_filename, artifact)
         )
 
-    def _on_video(self, params: Any) -> None:
-        artifact = from_channel(params["artifact"])
-        self._force_video()._artifact_ready(artifact)
-
     def _on_viewport_size_changed(self, params: Any) -> None:
         self._viewport_size = params["viewportSize"]
 
@@ -823,6 +823,18 @@ async def screenshot(
     async def title(self) -> str:
         return await self._main_frame.title()
 
+    async def aria_snapshot(
+        self,
+        timeout: float = None,
+        depth: int = None,
+        mode: Literal["ai", "default"] = None,
+    ) -> str:
+        return await self._main_frame._channel.send(
+            "ariaSnapshot",
+            self._main_frame._timeout,
+            locals_to_params(locals()),
+        )
+
     async def close(self, runBeforeUnload: bool = None, reason: str = None) -> None:
         self._close_reason = reason
         self._close_was_called = True
@@ -1168,21 +1180,17 @@ async def pdf(
             await async_writefile(path, decoded_binary)
         return decoded_binary
 
-    def _force_video(self) -> Video:
-        if not self._video:
-            self._video = Video(self)
+    @property
+    def video(self) -> Optional[Video]:
+        # Video is only exposed when the page actually produced a recording artifact.
+        # The initializer carries the artifact; if absent, no video was recorded.
+        if not self._video._artifact:
+            return None
         return self._video
 
     @property
-    def video(
-        self,
-    ) -> Optional[Video]:
-        # Note: we are creating Video object lazily, because we do not know
-        # BrowserContextOptions when constructing the page - it is assigned
-        # too late during launchPersistentContext.
-        if not self._browser_context._videos_dir:
-            return None
-        return self._force_video()
+    def screencast(self) -> Screencast:
+        return self._screencast
 
     def _close_error_with_reason(self) -> TargetClosedError:
         return TargetClosedError(
@@ -1435,8 +1443,12 @@ async def requests(self) -> List[Request]:
         request_objects = await self._channel.send("requests", None)
         return [from_channel(r) for r in request_objects]
 
-    async def console_messages(self) -> List[ConsoleMessage]:
-        message_dicts = await self._channel.send("consoleMessages", None)
+    async def console_messages(
+        self, filter: Literal["all", "since-navigation"] = None
+    ) -> List[ConsoleMessage]:
+        message_dicts = await self._channel.send(
+            "consoleMessages", None, locals_to_params(locals())
+        )
         return [
             ConsoleMessage(
                 {**event, "page": self._channel}, self._loop, self._dispatcher_fiber
@@ -1444,10 +1456,27 @@ async def console_messages(self) -> List[ConsoleMessage]:
             for event in message_dicts
         ]
 
-    async def page_errors(self) -> List[Error]:
-        error_objects = await self._channel.send("pageErrors", None)
+    async def page_errors(
+        self, filter: Literal["all", "since-navigation"] = None
+    ) -> List[Error]:
+        error_objects = await self._channel.send(
+            "pageErrors", None, locals_to_params(locals())
+        )
         return [parse_error(error["error"]) for error in error_objects]
 
+    async def clear_console_messages(self) -> None:
+        await self._channel.send("clearConsoleMessages", None)
+
+    async def clear_page_errors(self) -> None:
+        await self._channel.send("clearPageErrors", None)
+
+    async def pick_locator(self) -> "Locator":
+        selector = await self._channel.send("pickLocator", None, {})
+        return self.locator(selector)
+
+    async def cancel_pick_locator(self) -> None:
+        await self._channel.send("cancelPickLocator", None, {})
+
 
 class Worker(ChannelOwner):
     Events = SimpleNamespace(Close="close", Console="console")
diff --git a/playwright/_impl/_screencast.py b/playwright/_impl/_screencast.py
new file mode 100644
index 000000000..1f19c7220
--- /dev/null
+++ b/playwright/_impl/_screencast.py
@@ -0,0 +1,130 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import base64
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Literal, Optional, Union
+
+from playwright._impl._api_structures import ScreencastFrame
+from playwright._impl._artifact import Artifact
+from playwright._impl._connection import from_nullable_channel
+from playwright._impl._errors import Error
+from playwright._impl._helper import locals_to_params
+
+if TYPE_CHECKING:  # pragma: no cover
+    from playwright._impl._page import Page
+
+
+ScreencastFrameCallback = Callable[[ScreencastFrame], Any]
+ScreencastPosition = Literal[
+    "bottom",
+    "bottom-left",
+    "bottom-right",
+    "top",
+    "top-left",
+    "top-right",
+]
+
+
+class Screencast:
+    def __init__(self, page: "Page") -> None:
+        self._page = page
+        self._loop = page._loop
+        self._dispatcher_fiber = page._dispatcher_fiber
+        self._started = False
+        self._save_path: Optional[Union[str, Path]] = None
+        self._on_frame: Optional[ScreencastFrameCallback] = None
+        self._artifact: Optional[Artifact] = None
+        page._channel.on("screencastFrame", lambda params: self._dispatch_frame(params))
+
+    def _dispatch_frame(self, params: dict) -> None:
+        if not self._on_frame:
+            return
+        data = params["data"]
+        if isinstance(data, str):
+            data = base64.b64decode(data)
+        result = self._on_frame({"data": data})
+        if hasattr(result, "__await__"):
+            self._page._loop.create_task(result)
+
+    async def start(
+        self,
+        onFrame: ScreencastFrameCallback = None,
+        path: Union[str, Path] = None,
+        quality: int = None,
+    ) -> None:
+        if self._started:
+            raise Error("Screencast is already started")
+        self._started = True
+        self._on_frame = onFrame
+        result = await self._page._channel.send_return_as_dict(
+            "screencastStart",
+            None,
+            {
+                "quality": quality,
+                "sendFrames": bool(onFrame),
+                "record": bool(path),
+            },
+        )
+        artifact_channel = (result or {}).get("artifact")
+        if artifact_channel:
+            self._artifact = from_nullable_channel(artifact_channel)
+            self._save_path = path
+
+    async def stop(self) -> None:
+        self._started = False
+        self._on_frame = None
+        await self._page._channel.send("screencastStop", None)
+        if self._save_path and self._artifact:
+            await self._artifact.save_as(self._save_path)
+        self._artifact = None
+        self._save_path = None
+
+    async def show_actions(
+        self,
+        duration: float = None,
+        position: ScreencastPosition = None,
+        fontSize: int = None,
+    ) -> None:
+        await self._page._channel.send(
+            "screencastShowActions", None, locals_to_params(locals())
+        )
+
+    async def hide_actions(self) -> None:
+        await self._page._channel.send("screencastHideActions", None)
+
+    async def show_overlay(self, html: str, duration: float = None) -> None:
+        await self._page._channel.send(
+            "screencastShowOverlay", None, locals_to_params(locals())
+        )
+
+    async def show_chapter(
+        self,
+        title: str,
+        description: str = None,
+        duration: float = None,
+    ) -> None:
+        await self._page._channel.send(
+            "screencastChapter", None, locals_to_params(locals())
+        )
+
+    async def show_overlays(self) -> None:
+        await self._page._channel.send(
+            "screencastSetOverlayVisible", None, {"visible": True}
+        )
+
+    async def hide_overlays(self) -> None:
+        await self._page._channel.send(
+            "screencastSetOverlayVisible", None, {"visible": False}
+        )
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index bbc6ec35e..8dda75994 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -27,6 +27,7 @@ def __init__(
     ) -> None:
         super().__init__(parent, type, guid, initializer)
         self._include_sources: bool = False
+        self._is_live: bool = False
         self._stacks_id: Optional[str] = None
         self._is_tracing: bool = False
         self._traces_dir: Optional[str] = None
@@ -38,11 +39,22 @@ async def start(
         snapshots: bool = None,
         screenshots: bool = None,
         sources: bool = None,
+        live: bool = None,
     ) -> None:
         params = locals_to_params(locals())
         self._include_sources = bool(sources)
+        self._is_live = bool(live)
 
-        await self._channel.send("tracingStart", None, params)
+        await self._channel.send(
+            "tracingStart",
+            None,
+            {
+                "name": name,
+                "snapshots": snapshots,
+                "screenshots": screenshots,
+                "live": live,
+            },
+        )
         trace_name = await self._channel.send(
             "tracingStartChunk", None, {"title": title, "name": name}
         )
@@ -58,7 +70,7 @@ async def _start_collecting_stacks(self, trace_name: str) -> None:
             self._is_tracing = True
             self._connection.set_is_tracing(True)
         self._stacks_id = await self._connection.local_utils.tracing_started(
-            self._traces_dir, trace_name
+            self._traces_dir, trace_name, self._is_live
         )
 
     async def stop_chunk(self, path: Union[pathlib.Path, str] = None) -> None:
diff --git a/playwright/_impl/_video.py b/playwright/_impl/_video.py
index 68dedf6f8..e991803e3 100644
--- a/playwright/_impl/_video.py
+++ b/playwright/_impl/_video.py
@@ -13,7 +13,7 @@
 # limitations under the License.
 
 import pathlib
-from typing import TYPE_CHECKING, Union
+from typing import TYPE_CHECKING, Optional, Union
 
 from playwright._impl._artifact import Artifact
 from playwright._impl._helper import Error
@@ -23,49 +23,34 @@
 
 
 class Video:
-    def __init__(self, page: "Page") -> None:
+    def __init__(self, page: "Page", artifact: Optional[Artifact]) -> None:
         self._loop = page._loop
         self._dispatcher_fiber = page._dispatcher_fiber
         self._page = page
-        self._artifact_future = page._loop.create_future()
-        if page.is_closed():
-            self._page_closed()
-        else:
-            page.on("close", lambda page: self._page_closed())
+        self._is_remote = page._connection.is_remote
+        self._artifact = artifact
 
     def __repr__(self) -> str:
         return f"<Video page={self._page}>"
 
-    def _page_closed(self) -> None:
-        if not self._artifact_future.done():
-            self._artifact_future.set_exception(Error("Page closed"))
-
-    def _artifact_ready(self, artifact: Artifact) -> None:
-        if not self._artifact_future.done():
-            self._artifact_future.set_result(artifact)
-
     async def path(self) -> pathlib.Path:
-        if self._page._connection.is_remote:
+        if self._is_remote:
             raise Error(
                 "Path is not available when using browserType.connect(). Use save_as() to save a local copy."
             )
-        artifact = await self._artifact_future
-        if not artifact:
-            raise Error("Page did not produce any video frames")
-        return artifact.absolute_path
+        if not self._artifact:
+            raise Error("Video recording has not been started.")
+        return self._artifact.absolute_path
 
     async def save_as(self, path: Union[str, pathlib.Path]) -> None:
         if self._page._connection._is_sync and not self._page._is_closed:
             raise Error(
                 "Page is not yet closed. Close the page prior to calling save_as"
             )
-        artifact = await self._artifact_future
-        if not artifact:
-            raise Error("Page did not produce any video frames")
-        await artifact.save_as(path)
+        if not self._artifact:
+            raise Error("Video recording has not been started.")
+        await self._artifact.save_as(path)
 
     async def delete(self) -> None:
-        artifact = await self._artifact_future
-        if not artifact:
-            raise Error("Page did not produce any video frames")
-        await artifact.delete()
+        if self._artifact:
+            await self._artifact.delete()
diff --git a/playwright/async_api/__init__.py b/playwright/async_api/__init__.py
index c05735fcd..6508994c3 100644
--- a/playwright/async_api/__init__.py
+++ b/playwright/async_api/__init__.py
@@ -72,10 +72,14 @@
 FloatRect = playwright._impl._api_structures.FloatRect
 Geolocation = playwright._impl._api_structures.Geolocation
 HttpCredentials = playwright._impl._api_structures.HttpCredentials
+BrowserBindResult = playwright._impl._api_structures.BrowserBindResult
+DebuggerLocation = playwright._impl._api_structures.DebuggerLocation
+DebuggerPausedDetails = playwright._impl._api_structures.DebuggerPausedDetails
 PdfMargins = playwright._impl._api_structures.PdfMargins
 Position = playwright._impl._api_structures.Position
 ProxySettings = playwright._impl._api_structures.ProxySettings
 ResourceTiming = playwright._impl._api_structures.ResourceTiming
+ScreencastFrame = playwright._impl._api_structures.ScreencastFrame
 SourceLocation = playwright._impl._api_structures.SourceLocation
 StorageState = playwright._impl._api_structures.StorageState
 StorageStateCookie = playwright._impl._api_structures.StorageStateCookie
@@ -153,6 +157,7 @@ def __call__(
     "APIRequestContext",
     "APIResponse",
     "Browser",
+    "BrowserBindResult",
     "BrowserContext",
     "BrowserType",
     "CDPSession",
@@ -174,6 +179,8 @@ def __call__(
     "Keyboard",
     "Locator",
     "Mouse",
+    "DebuggerLocation",
+    "DebuggerPausedDetails",
     "Page",
     "PdfMargins",
     "Position",
@@ -183,6 +190,7 @@ def __call__(
     "ResourceTiming",
     "Response",
     "Route",
+    "ScreencastFrame",
     "Selectors",
     "SourceLocation",
     "StorageState",
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index bd694886d..7119b9d84 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -19,8 +19,11 @@
 from typing import Literal
 
 from playwright._impl._api_structures import (
+    BrowserBindResult,
     ClientCertificate,
     Cookie,
+    DebuggerLocation,
+    DebuggerPausedDetails,
     FilePayload,
     FloatRect,
     Geolocation,
@@ -32,6 +35,7 @@
     RemoteAddr,
     RequestSizes,
     ResourceTiming,
+    ScreencastFrame,
     SecurityDetails,
     SetCookieParam,
     SourceLocation,
@@ -56,6 +60,7 @@
 from playwright._impl._cdp_session import CDPSession as CDPSessionImpl
 from playwright._impl._clock import Clock as ClockImpl
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
+from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
@@ -79,6 +84,7 @@
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
+from playwright._impl._screencast import Screencast as ScreencastImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._tracing import Tracing as TracingImpl
 from playwright._impl._video import Video as VideoImpl
@@ -182,6 +188,21 @@ def post_data_buffer(self) -> typing.Optional[bytes]:
         """
         return mapping.from_maybe_impl(self._impl_obj.post_data_buffer)
 
+    @property
+    def existing_response(self) -> typing.Optional["Response"]:
+        """Request.existing_response
+
+        Returns the `Response` object if the response has already been received, `null` otherwise.
+
+        Unlike `request.response()`, this method does not wait for the response to arrive. It returns immediately
+        with the response object if the response has been received, or `null` if the response has not been received yet.
+
+        Returns
+        -------
+        Union[Response, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.existing_response)
+
     @property
     def frame(self) -> "Frame":
         """Request.frame
@@ -591,6 +612,18 @@ async def security_details(self) -> typing.Optional[SecurityDetails]:
 
         return mapping.from_impl_nullable(await self._impl_obj.security_details())
 
+    async def http_version(self) -> str:
+        """Response.http_version
+
+        Returns the http version used by the response.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.http_version())
+
     async def finished(self) -> None:
         """Response.finished
 
@@ -3361,7 +3394,7 @@ def expect_navigation(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str, None]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -3412,7 +3445,7 @@ async def wait_for_url(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -4817,7 +4850,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -4917,7 +4950,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         await page.get_by_test_id(\"directions\").click()
@@ -6304,7 +6337,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -6404,7 +6437,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         await page.get_by_test_id(\"directions\").click()
@@ -7089,6 +7122,18 @@ def location(self) -> SourceLocation:
         """
         return mapping.from_impl(self._impl_obj.location)
 
+    @property
+    def timestamp(self) -> float:
+        """ConsoleMessage.timestamp
+
+        The timestamp of the console message in milliseconds since the Unix epoch.
+
+        Returns
+        -------
+        float
+        """
+        return mapping.from_maybe_impl(self._impl_obj.timestamp)
+
     @property
     def page(self) -> typing.Optional["Page"]:
         """ConsoleMessage.page
@@ -7118,6 +7163,115 @@ def worker(self) -> typing.Optional["Worker"]:
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
 
+class Debugger(AsyncBase):
+
+    @typing.overload
+    def on(
+        self,
+        event: Literal["pausedstatechanged"],
+        f: typing.Callable[["None"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when the debugger pauses or resumes."""
+
+    @typing.overload
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
+        return super().on(event=event, f=f)
+
+    @typing.overload
+    def once(
+        self,
+        event: Literal["pausedstatechanged"],
+        f: typing.Callable[["None"], "typing.Union[typing.Awaitable[None], None]"],
+    ) -> None:
+        """
+        Emitted when the debugger pauses or resumes."""
+
+    @typing.overload
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
+        return super().once(event=event, f=f)
+
+    @property
+    def paused_details(self) -> typing.Optional[DebuggerPausedDetails]:
+        """Debugger.paused_details
+
+        Returns details about the currently paused call. Returns `null` if the debugger is not paused.
+
+        Returns
+        -------
+        Union[{location: {file: str, line: Union[int, None], column: Union[int, None]}, title: str}, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.paused_details)
+
+    async def request_pause(self) -> None:
+        """Debugger.request_pause
+
+        Configures the debugger to pause before the next action is executed.
+
+        Throws if the debugger is already paused. Use `debugger.next()` or `debugger.run_to()` to step while
+        paused.
+
+        Note that `page.pause()` is equivalent to a \"debugger\" statement — it pauses execution at the call site
+        immediately. On the contrary, `debugger.request_pause()` is equivalent to \"pause on next statement\" — it
+        configures the debugger to pause before the next action is executed.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.request_pause())
+
+    async def resume(self) -> None:
+        """Debugger.resume
+
+        Resumes script execution. Throws if the debugger is not paused.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.resume())
+
+    async def next(self) -> None:
+        """Debugger.next
+
+        Resumes script execution and pauses again before the next action. Throws if the debugger is not paused.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.next())
+
+    async def run_to(self, location: DebuggerLocation) -> None:
+        """Debugger.run_to
+
+        Resumes script execution and pauses when an action originates from the given source location. Throws if the
+        debugger is not paused.
+
+        Parameters
+        ----------
+        location : {file: str, line: Union[int, None], column: Union[int, None]}
+            The source location to pause at.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.run_to(location=location))
+
+
+mapping.register(DebuggerImpl, Debugger)
+
+
 class Dialog(AsyncBase):
 
     @property
@@ -7305,6 +7459,157 @@ async def cancel(self) -> None:
 mapping.register(DownloadImpl, Download)
 
 
+class Screencast(AsyncBase):
+
+    async def start(
+        self,
+        *,
+        on_frame: typing.Optional[
+            typing.Callable[[ScreencastFrame], typing.Any]
+        ] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        quality: typing.Optional[int] = None,
+    ) -> None:
+        """Screencast.start
+
+        Starts the screencast. When `path` is provided, it saves video recording to the specified file. When `onFrame` is
+        provided, delivers JPEG-encoded frames to the callback. Both can be used together.
+
+        **Usage**
+
+        Parameters
+        ----------
+        on_frame : Union[Callable[[{data: bytes}], Any], None]
+            Callback that receives JPEG-encoded frame data.
+        path : Union[pathlib.Path, str, None]
+            Path where the video should be saved when the screencast is stopped. When provided, video recording is started.
+        quality : Union[int, None]
+            The quality of the image, between 0-100.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.start(
+                onFrame=self._wrap_handler(on_frame), path=path, quality=quality
+            )
+        )
+
+    async def stop(self) -> None:
+        """Screencast.stop
+
+        Stops the screencast and video recording if active. If a video was being recorded, saves it to the path specified
+        in `screencast.start()`.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.stop())
+
+    async def show_actions(
+        self,
+        *,
+        duration: typing.Optional[float] = None,
+        position: typing.Optional[
+            Literal[
+                "bottom", "bottom-left", "bottom-right", "top", "top-left", "top-right"
+            ]
+        ] = None,
+        font_size: typing.Optional[int] = None,
+    ) -> None:
+        """Screencast.show_actions
+
+        Enables visual annotations on interacted elements. Returns a disposable that stops showing actions when disposed.
+
+        Parameters
+        ----------
+        duration : Union[float, None]
+            How long each annotation is displayed in milliseconds. Defaults to `500`.
+        position : Union["bottom", "bottom-left", "bottom-right", "top", "top-left", "top-right", None]
+            Position of the action title overlay. Defaults to `"top-right"`.
+        font_size : Union[int, None]
+            Font size of the action title in pixels. Defaults to `24`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.show_actions(
+                duration=duration, position=position, fontSize=font_size
+            )
+        )
+
+    async def hide_actions(self) -> None:
+        """Screencast.hide_actions
+
+        Removes action decorations.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.hide_actions())
+
+    async def show_overlay(
+        self, html: str, *, duration: typing.Optional[float] = None
+    ) -> None:
+        """Screencast.show_overlay
+
+        Adds an overlay with the given HTML content. The overlay is displayed on top of the page until removed. Returns a
+        disposable that removes the overlay when disposed.
+
+        Parameters
+        ----------
+        html : str
+            HTML content for the overlay.
+        duration : Union[float, None]
+            Duration in milliseconds after which the overlay is automatically removed. Overlay stays until dismissed if not
+            provided.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.show_overlay(html=html, duration=duration)
+        )
+
+    async def show_chapter(
+        self,
+        title: str,
+        *,
+        description: typing.Optional[str] = None,
+        duration: typing.Optional[float] = None,
+    ) -> None:
+        """Screencast.show_chapter
+
+        Shows a chapter overlay with a title and optional description, centered on the page with a blurred backdrop. Useful
+        for narrating video recordings. The overlay is removed after the specified duration, or 2000ms.
+
+        Parameters
+        ----------
+        title : str
+            Title text displayed prominently in the overlay.
+        description : Union[str, None]
+            Optional description text displayed below the title.
+        duration : Union[float, None]
+            Duration in milliseconds after which the overlay is automatically removed. Defaults to `2000`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.show_chapter(
+                title=title, description=description, duration=duration
+            )
+        )
+
+    async def show_overlays(self) -> None:
+        """Screencast.show_overlays
+
+        Shows overlays.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.show_overlays())
+
+    async def hide_overlays(self) -> None:
+        """Screencast.hide_overlays
+
+        Hides overlays without removing them.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.hide_overlays())
+
+
+mapping.register(ScreencastImpl, Screencast)
+
+
 class Video(AsyncBase):
 
     async def path(self) -> pathlib.Path:
@@ -8019,7 +8324,8 @@ def request(self) -> "APIRequestContext":
     def video(self) -> typing.Optional["Video"]:
         """Page.video
 
-        Video object associated with this page.
+        Video object associated with this page. Can be used to access the video file when using the `recordVideo` context
+        option.
 
         Returns
         -------
@@ -8027,6 +8333,20 @@ def video(self) -> typing.Optional["Video"]:
         """
         return mapping.from_impl_nullable(self._impl_obj.video)
 
+    @property
+    def screencast(self) -> "Screencast":
+        """Page.screencast
+
+        `Screencast` object associated with this page.
+
+        **Usage**
+
+        Returns
+        -------
+        Screencast
+        """
+        return mapping.from_impl(self._impl_obj.screencast)
+
     async def opener(self) -> typing.Optional["Page"]:
         """Page.opener
 
@@ -9164,7 +9484,7 @@ async def wait_for_url(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -9534,6 +9854,8 @@ async def handle_route(route: Route):
         await page.route(\"/api/**\", handle_route)
         ```
 
+        If a request matches multiple registered routes, the most recently registered route takes precedence.
+
         Page routes take precedence over browser context routes (set up with `browser_context.route()`) when request
         matches both handlers.
 
@@ -9579,7 +9901,7 @@ async def unroute(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while routing.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
             Optional handler function to route the request.
         """
@@ -9818,6 +10140,37 @@ async def title(self) -> str:
 
         return mapping.from_maybe_impl(await self._impl_obj.title())
 
+    async def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        depth: typing.Optional[int] = None,
+        mode: typing.Optional[Literal["ai", "default"]] = None,
+    ) -> str:
+        """Page.aria_snapshot
+
+        Captures the aria snapshot of the page. Read more about [aria snapshots](https://playwright.dev/python/docs/aria-snapshots).
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+        depth : Union[int, None]
+            When specified, limits the depth of the snapshot.
+        mode : Union["ai", "default", None]
+            When set to `"ai"`, returns a snapshot optimized for AI consumption: including element references like `[ref=e2]`
+            and snapshots of `<iframe>`s. Defaults to `"default"`.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.aria_snapshot(timeout=timeout, depth=depth, mode=mode)
+        )
+
     async def close(
         self,
         *,
@@ -10441,7 +10794,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -10541,7 +10894,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         await page.get_by_test_id(\"directions\").click()
@@ -11860,7 +12213,7 @@ def expect_navigation(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str, None]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -12331,29 +12684,92 @@ async def requests(self) -> typing.List["Request"]:
 
         return mapping.from_impl_list(await self._impl_obj.requests())
 
-    async def console_messages(self) -> typing.List["ConsoleMessage"]:
+    async def console_messages(
+        self, *, filter: typing.Optional[Literal["all", "since-navigation"]] = None
+    ) -> typing.List["ConsoleMessage"]:
         """Page.console_messages
 
         Returns up to (currently) 200 last console messages from this page. See `page.on('console')` for more details.
 
+        Parameters
+        ----------
+        filter : Union["all", "since-navigation", None]
+            Controls which messages are returned:
+
         Returns
         -------
         List[ConsoleMessage]
         """
 
-        return mapping.from_impl_list(await self._impl_obj.console_messages())
+        return mapping.from_impl_list(
+            await self._impl_obj.console_messages(filter=filter)
+        )
 
-    async def page_errors(self) -> typing.List["Error"]:
+    async def page_errors(
+        self, *, filter: typing.Optional[Literal["all", "since-navigation"]] = None
+    ) -> typing.List["Error"]:
         """Page.page_errors
 
         Returns up to (currently) 200 last page errors from this page. See `page.on('page_error')` for more details.
 
+        Parameters
+        ----------
+        filter : Union["all", "since-navigation", None]
+            Controls which errors are returned:
+
         Returns
         -------
         List[Error]
         """
 
-        return mapping.from_impl_list(await self._impl_obj.page_errors())
+        return mapping.from_impl_list(await self._impl_obj.page_errors(filter=filter))
+
+    async def clear_console_messages(self) -> None:
+        """Page.clear_console_messages
+
+        Clears all stored console messages from this page. Subsequent calls to `page.console_messages()` will only
+        return messages logged after the clear.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.clear_console_messages())
+
+    async def clear_page_errors(self) -> None:
+        """Page.clear_page_errors
+
+        Clears all stored page errors from this page. Subsequent calls to `page.page_errors()` will only return
+        errors thrown after the clear.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.clear_page_errors())
+
+    async def pick_locator(self) -> "Locator":
+        """Page.pick_locator
+
+        Enters pick locator mode where hovering over page elements highlights them and shows the corresponding locator.
+        Once the user clicks an element, the mode is deactivated and the `Locator` for the picked element is returned.
+
+        **Usage**
+
+        ```py
+        locator = await page.pick_locator()
+        print(locator)
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(await self._impl_obj.pick_locator())
+
+    async def cancel_pick_locator(self) -> None:
+        """Page.cancel_pick_locator
+
+        Cancels an ongoing `page.pick_locator()` call by deactivating pick locator mode. If no pick locator mode is
+        active, this method is a no-op.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.cancel_pick_locator())
 
 
 mapping.register(PageImpl, Page)
@@ -12800,6 +13216,18 @@ def tracing(self) -> "Tracing":
         """
         return mapping.from_impl(self._impl_obj.tracing)
 
+    @property
+    def debugger(self) -> "Debugger":
+        """BrowserContext.debugger
+
+        Debugger allows to pause and resume the execution.
+
+        Returns
+        -------
+        Debugger
+        """
+        return mapping.from_impl(self._impl_obj.debugger)
+
     @property
     def request(self) -> "APIRequestContext":
         """BrowserContext.request
@@ -12991,6 +13419,7 @@ async def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
+            - `'screen-wake-lock'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
@@ -13346,7 +13775,7 @@ async def unroute(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with
+            A glob pattern, regex pattern, or predicate receiving [URL] used to register a routing with
             `browser_context.route()`.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
             Optional handler function used to register a routing with `browser_context.route()`.
@@ -13523,6 +13952,18 @@ def expect_event(
             ).future
         )
 
+    def is_closed(self) -> bool:
+        """BrowserContext.is_closed
+
+        Indicates that the browser context is in the process of closing or has already been closed.
+
+        Returns
+        -------
+        bool
+        """
+
+        return mapping.from_maybe_impl(self._impl_obj.is_closed())
+
     async def close(self, *, reason: typing.Optional[str] = None) -> None:
         """BrowserContext.close
 
@@ -13568,6 +14009,33 @@ async def storage_state(
             await self._impl_obj.storage_state(path=path, indexedDB=indexed_db)
         )
 
+    async def set_storage_state(
+        self, storage_state: typing.Union[StorageState, str, pathlib.Path]
+    ) -> None:
+        """BrowserContext.set_storage_state
+
+        Clears the existing cookies, local storage and IndexedDB entries for all origins and sets the new storage state.
+
+        **Usage**
+
+        ```py
+        # Load storage state from a file and apply it to the context.
+        await context.set_storage_state(\"state.json\")
+        ```
+
+        Parameters
+        ----------
+        storage_state : Union[pathlib.Path, str, {cookies: Sequence[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: Sequence[{origin: str, localStorage: Sequence[{name: str, value: str}]}]}]
+            Learn more about [storage state and auth](../auth.md).
+
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`.
+        """
+
+        return mapping.from_maybe_impl(
+            await self._impl_obj.set_storage_state(storageState=storage_state)
+        )
+
     async def wait_for_event(
         self,
         event: str,
@@ -13695,6 +14163,58 @@ async def new_cdp_session(
 
 class CDPSession(AsyncBase):
 
+    @typing.overload
+    def on(
+        self,
+        event: Literal["close"],
+        f: typing.Callable[
+            ["CDPSession"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when the session is closed, either because the target was closed or `session.detach()` was called.
+        """
+
+    @typing.overload
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
+        return super().on(event=event, f=f)
+
+    @typing.overload
+    def once(
+        self,
+        event: Literal["close"],
+        f: typing.Callable[
+            ["CDPSession"], "typing.Union[typing.Awaitable[None], None]"
+        ],
+    ) -> None:
+        """
+        Emitted when the session is closed, either because the target was closed or `session.detach()` was called.
+        """
+
+    @typing.overload
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
+        return super().once(event=event, f=f)
+
     async def send(
         self, method: str, params: typing.Optional[typing.Dict] = None
     ) -> typing.Dict:
@@ -13731,6 +14251,7 @@ async def detach(self) -> None:
 
 class Browser(AsyncContextManager):
 
+    @typing.overload
     def on(
         self,
         event: Literal["disconnected"],
@@ -13741,8 +14262,22 @@ def on(
         following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
+
+    @typing.overload
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def on(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
         return super().on(event=event, f=f)
 
+    @typing.overload
     def once(
         self,
         event: Literal["disconnected"],
@@ -13753,6 +14288,19 @@ def once(
         following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
+
+    @typing.overload
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None: ...
+
+    def once(
+        self,
+        event: str,
+        f: typing.Callable[..., typing.Union[typing.Awaitable[None], None]],
+    ) -> None:
         return super().once(event=event, f=f)
 
     @property
@@ -14335,6 +14883,49 @@ async def new_browser_cdp_session(self) -> "CDPSession":
 
         return mapping.from_impl(await self._impl_obj.new_browser_cdp_session())
 
+    async def bind(
+        self,
+        title: str,
+        *,
+        workspace_dir: typing.Optional[str] = None,
+        host: typing.Optional[str] = None,
+        port: typing.Optional[int] = None,
+    ) -> BrowserBindResult:
+        """Browser.bind
+
+        Binds the browser to a named pipe or web socket, making it available for other clients to connect to.
+
+        Parameters
+        ----------
+        title : str
+            Title of the browser server, used for identification.
+        workspace_dir : Union[str, None]
+            Working directory associated with this browser server.
+        host : Union[str, None]
+            Host to bind the web socket server to. When specified, a web socket server is created instead of a named pipe.
+        port : Union[int, None]
+            Port to bind the web socket server to. When specified, a web socket server is created instead of a named pipe. Use
+            `0` to let the OS pick an available port.
+
+        Returns
+        -------
+        {endpoint: str}
+        """
+
+        return mapping.from_impl(
+            await self._impl_obj.bind(
+                title=title, workspaceDir=workspace_dir, host=host, port=port
+            )
+        )
+
+    async def unbind(self) -> None:
+        """Browser.unbind
+
+        Unbinds the browser server previously bound with `browser.bind()`.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.unbind())
+
     async def start_tracing(
         self,
         *,
@@ -14448,6 +15039,7 @@ async def launch(
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
         traces_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        artifacts_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
@@ -14529,6 +15121,10 @@ async def launch(
             on.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
+        artifacts_dir : Union[pathlib.Path, str, None]
+            If specified, artifacts (traces, videos, downloads, HAR files, etc.) are saved into this directory. The directory
+            is not cleaned up when the browser closes. If not specified, a temporary directory is used and cleaned up when the
+            browser closes.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
@@ -14559,6 +15155,7 @@ async def launch(
                 downloadsPath=downloads_path,
                 slowMo=slow_mo,
                 tracesDir=traces_dir,
+                artifactsDir=artifacts_dir,
                 chromiumSandbox=chromium_sandbox,
                 firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
             )
@@ -14610,6 +15207,7 @@ async def launch_persistent_context(
         contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        artifacts_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
@@ -14764,6 +15362,10 @@ async def launch_persistent_context(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
+        artifacts_dir : Union[pathlib.Path, str, None]
+            If specified, artifacts (traces, videos, downloads, HAR files, etc.) are saved into this directory. The directory
+            is not cleaned up when the browser closes. If not specified, a temporary directory is used and cleaned up when the
+            browser closes.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
@@ -14875,6 +15477,7 @@ async def launch_persistent_context(
                 contrast=contrast,
                 acceptDownloads=accept_downloads,
                 tracesDir=traces_dir,
+                artifactsDir=artifacts_dir,
                 chromiumSandbox=chromium_sandbox,
                 firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
                 recordHarPath=record_har_path,
@@ -14954,7 +15557,7 @@ async def connect_over_cdp(
 
     async def connect(
         self,
-        ws_endpoint: str,
+        endpoint: str,
         *,
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14970,7 +15573,7 @@ async def connect(
 
         Parameters
         ----------
-        ws_endpoint : str
+        endpoint : str
             A Playwright browser websocket endpoint to connect to. You obtain this endpoint via `BrowserServer.wsEndpoint`.
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the connection to be established. Defaults to `0` (no timeout).
@@ -15001,7 +15604,7 @@ async def connect(
 
         return mapping.from_impl(
             await self._impl_obj.connect(
-                wsEndpoint=ws_endpoint,
+                endpoint=endpoint,
                 timeout=timeout,
                 slowMo=slow_mo,
                 headers=mapping.to_impl(headers),
@@ -15149,6 +15752,7 @@ async def start(
         snapshots: typing.Optional[bool] = None,
         screenshots: typing.Optional[bool] = None,
         sources: typing.Optional[bool] = None,
+        live: typing.Optional[bool] = None,
     ) -> None:
         """Tracing.start
 
@@ -15188,6 +15792,10 @@ async def start(
             Whether to capture screenshots during tracing. Screenshots are used to build a timeline preview.
         sources : Union[bool, None]
             Whether to include source files for trace actions.
+        live : Union[bool, None]
+            When enabled, the trace is written to an unarchived file that is updated in real time as actions occur, instead of
+            caching changes and archiving them into a zip file at the end. This is useful for live trace viewing during test
+            execution.
         """
 
         return mapping.from_maybe_impl(
@@ -15197,6 +15805,7 @@ async def start(
                 snapshots=snapshots,
                 screenshots=screenshots,
                 sources=sources,
+                live=live,
             )
         )
 
@@ -16283,7 +16892,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         await expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -16383,7 +16992,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         await page.get_by_test_id(\"directions\").click()
@@ -17406,7 +18015,13 @@ async def screenshot(
             )
         )
 
-    async def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
+    async def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        depth: typing.Optional[int] = None,
+        mode: typing.Optional[Literal["ai", "default"]] = None,
+    ) -> str:
         """Locator.aria_snapshot
 
         Captures the aria snapshot of the given element. Read more about [aria snapshots](https://playwright.dev/python/docs/aria-snapshots) and
@@ -17446,11 +18061,20 @@ async def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
             - link \"About\"
         ```
 
+        An AI-optimized snapshot, controlled by `mode`, is different from a default snapshot:
+        1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when
+           no elements match. 3. Includes snapshots of `<iframe>`s inside the target.
+
         Parameters
         ----------
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+        depth : Union[int, None]
+            When specified, limits the depth of the snapshot.
+        mode : Union["ai", "default", None]
+            When set to `"ai"`, returns a snapshot optimized for AI consumption. Defaults to `"default"`. See details for more
+            information.
 
         Returns
         -------
@@ -17458,9 +18082,23 @@ async def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
         """
 
         return mapping.from_maybe_impl(
-            await self._impl_obj.aria_snapshot(timeout=timeout)
+            await self._impl_obj.aria_snapshot(timeout=timeout, depth=depth, mode=mode)
         )
 
+    async def normalize(self) -> "Locator":
+        """Locator.normalize
+
+        Returns a new locator that uses best practices for referencing the matched element, prioritizing test ids, aria
+        roles, and other user-facing attributes over CSS selectors. This is useful for converting implementation-detail
+        selectors into more resilient, human-readable locators.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(await self._impl_obj.normalize())
+
     async def scroll_into_view_if_needed(
         self, *, timeout: typing.Optional[float] = None
     ) -> None:
@@ -18221,7 +18859,7 @@ async def delete(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18302,7 +18940,7 @@ async def head(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18383,7 +19021,7 @@ async def get(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18476,7 +19114,7 @@ async def patch(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18557,7 +19195,7 @@ async def put(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18638,7 +19276,7 @@ async def post(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18751,7 +19389,7 @@ async def fetch(
         ] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
diff --git a/playwright/sync_api/__init__.py b/playwright/sync_api/__init__.py
index 53dee2cad..6015bc1be 100644
--- a/playwright/sync_api/__init__.py
+++ b/playwright/sync_api/__init__.py
@@ -72,10 +72,14 @@
 FloatRect = playwright._impl._api_structures.FloatRect
 Geolocation = playwright._impl._api_structures.Geolocation
 HttpCredentials = playwright._impl._api_structures.HttpCredentials
+BrowserBindResult = playwright._impl._api_structures.BrowserBindResult
+DebuggerLocation = playwright._impl._api_structures.DebuggerLocation
+DebuggerPausedDetails = playwright._impl._api_structures.DebuggerPausedDetails
 PdfMargins = playwright._impl._api_structures.PdfMargins
 Position = playwright._impl._api_structures.Position
 ProxySettings = playwright._impl._api_structures.ProxySettings
 ResourceTiming = playwright._impl._api_structures.ResourceTiming
+ScreencastFrame = playwright._impl._api_structures.ScreencastFrame
 SourceLocation = playwright._impl._api_structures.SourceLocation
 StorageState = playwright._impl._api_structures.StorageState
 StorageStateCookie = playwright._impl._api_structures.StorageStateCookie
@@ -152,6 +156,7 @@ def __call__(
     "APIRequestContext",
     "APIResponse",
     "Browser",
+    "BrowserBindResult",
     "BrowserContext",
     "BrowserType",
     "CDPSession",
@@ -173,6 +178,8 @@ def __call__(
     "Keyboard",
     "Locator",
     "Mouse",
+    "DebuggerLocation",
+    "DebuggerPausedDetails",
     "Page",
     "PdfMargins",
     "Position",
@@ -182,6 +189,7 @@ def __call__(
     "ResourceTiming",
     "Response",
     "Route",
+    "ScreencastFrame",
     "Selectors",
     "SourceLocation",
     "StorageState",
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index 0df2087df..d7809f507 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -19,8 +19,11 @@
 from typing import Literal
 
 from playwright._impl._api_structures import (
+    BrowserBindResult,
     ClientCertificate,
     Cookie,
+    DebuggerLocation,
+    DebuggerPausedDetails,
     FilePayload,
     FloatRect,
     Geolocation,
@@ -32,6 +35,7 @@
     RemoteAddr,
     RequestSizes,
     ResourceTiming,
+    ScreencastFrame,
     SecurityDetails,
     SetCookieParam,
     SourceLocation,
@@ -50,6 +54,7 @@
 from playwright._impl._cdp_session import CDPSession as CDPSessionImpl
 from playwright._impl._clock import Clock as ClockImpl
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
+from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
@@ -73,6 +78,7 @@
 from playwright._impl._page import Page as PageImpl
 from playwright._impl._page import Worker as WorkerImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
+from playwright._impl._screencast import Screencast as ScreencastImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
 from playwright._impl._sync_base import (
     EventContextManager,
@@ -182,6 +188,21 @@ def post_data_buffer(self) -> typing.Optional[bytes]:
         """
         return mapping.from_maybe_impl(self._impl_obj.post_data_buffer)
 
+    @property
+    def existing_response(self) -> typing.Optional["Response"]:
+        """Request.existing_response
+
+        Returns the `Response` object if the response has already been received, `null` otherwise.
+
+        Unlike `request.response()`, this method does not wait for the response to arrive. It returns immediately
+        with the response object if the response has been received, or `null` if the response has not been received yet.
+
+        Returns
+        -------
+        Union[Response, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.existing_response)
+
     @property
     def frame(self) -> "Frame":
         """Request.frame
@@ -597,6 +618,18 @@ def security_details(self) -> typing.Optional[SecurityDetails]:
 
         return mapping.from_impl_nullable(self._sync(self._impl_obj.security_details()))
 
+    def http_version(self) -> str:
+        """Response.http_version
+
+        Returns the http version used by the response.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.http_version()))
+
     def finished(self) -> None:
         """Response.finished
 
@@ -3411,7 +3444,7 @@ def expect_navigation(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str, None]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -3462,7 +3495,7 @@ def wait_for_url(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -4896,7 +4929,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -4996,7 +5029,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         page.get_by_test_id(\"directions\").click()
@@ -6410,7 +6443,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -6510,7 +6543,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         page.get_by_test_id(\"directions\").click()
@@ -7179,6 +7212,18 @@ def location(self) -> SourceLocation:
         """
         return mapping.from_impl(self._impl_obj.location)
 
+    @property
+    def timestamp(self) -> float:
+        """ConsoleMessage.timestamp
+
+        The timestamp of the console message in milliseconds since the Unix epoch.
+
+        Returns
+        -------
+        float
+        """
+        return mapping.from_maybe_impl(self._impl_obj.timestamp)
+
     @property
     def page(self) -> typing.Optional["Page"]:
         """ConsoleMessage.page
@@ -7208,6 +7253,97 @@ def worker(self) -> typing.Optional["Worker"]:
 mapping.register(ConsoleMessageImpl, ConsoleMessage)
 
 
+class Debugger(SyncBase):
+
+    @typing.overload
+    def on(
+        self, event: Literal["pausedstatechanged"], f: typing.Callable[["None"], "None"]
+    ) -> None:
+        """
+        Emitted when the debugger pauses or resumes."""
+
+    @typing.overload
+    def on(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def on(self, event: str, f: typing.Callable[..., None]) -> None:
+        return super().on(event=event, f=f)
+
+    @typing.overload
+    def once(
+        self, event: Literal["pausedstatechanged"], f: typing.Callable[["None"], "None"]
+    ) -> None:
+        """
+        Emitted when the debugger pauses or resumes."""
+
+    @typing.overload
+    def once(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def once(self, event: str, f: typing.Callable[..., None]) -> None:
+        return super().once(event=event, f=f)
+
+    @property
+    def paused_details(self) -> typing.Optional[DebuggerPausedDetails]:
+        """Debugger.paused_details
+
+        Returns details about the currently paused call. Returns `null` if the debugger is not paused.
+
+        Returns
+        -------
+        Union[{location: {file: str, line: Union[int, None], column: Union[int, None]}, title: str}, None]
+        """
+        return mapping.from_impl_nullable(self._impl_obj.paused_details)
+
+    def request_pause(self) -> None:
+        """Debugger.request_pause
+
+        Configures the debugger to pause before the next action is executed.
+
+        Throws if the debugger is already paused. Use `debugger.next()` or `debugger.run_to()` to step while
+        paused.
+
+        Note that `page.pause()` is equivalent to a \"debugger\" statement — it pauses execution at the call site
+        immediately. On the contrary, `debugger.request_pause()` is equivalent to \"pause on next statement\" — it
+        configures the debugger to pause before the next action is executed.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.request_pause()))
+
+    def resume(self) -> None:
+        """Debugger.resume
+
+        Resumes script execution. Throws if the debugger is not paused.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.resume()))
+
+    def next(self) -> None:
+        """Debugger.next
+
+        Resumes script execution and pauses again before the next action. Throws if the debugger is not paused.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.next()))
+
+    def run_to(self, location: DebuggerLocation) -> None:
+        """Debugger.run_to
+
+        Resumes script execution and pauses when an action originates from the given source location. Throws if the
+        debugger is not paused.
+
+        Parameters
+        ----------
+        location : {file: str, line: Union[int, None], column: Union[int, None]}
+            The source location to pause at.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.run_to(location=location))
+        )
+
+
+mapping.register(DebuggerImpl, Debugger)
+
+
 class Dialog(SyncBase):
 
     @property
@@ -7395,6 +7531,163 @@ def cancel(self) -> None:
 mapping.register(DownloadImpl, Download)
 
 
+class Screencast(SyncBase):
+
+    def start(
+        self,
+        *,
+        on_frame: typing.Optional[
+            typing.Callable[[ScreencastFrame], typing.Any]
+        ] = None,
+        path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        quality: typing.Optional[int] = None,
+    ) -> None:
+        """Screencast.start
+
+        Starts the screencast. When `path` is provided, it saves video recording to the specified file. When `onFrame` is
+        provided, delivers JPEG-encoded frames to the callback. Both can be used together.
+
+        **Usage**
+
+        Parameters
+        ----------
+        on_frame : Union[Callable[[{data: bytes}], Any], None]
+            Callback that receives JPEG-encoded frame data.
+        path : Union[pathlib.Path, str, None]
+            Path where the video should be saved when the screencast is stopped. When provided, video recording is started.
+        quality : Union[int, None]
+            The quality of the image, between 0-100.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.start(
+                    onFrame=self._wrap_handler(on_frame), path=path, quality=quality
+                )
+            )
+        )
+
+    def stop(self) -> None:
+        """Screencast.stop
+
+        Stops the screencast and video recording if active. If a video was being recorded, saves it to the path specified
+        in `screencast.start()`.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.stop()))
+
+    def show_actions(
+        self,
+        *,
+        duration: typing.Optional[float] = None,
+        position: typing.Optional[
+            Literal[
+                "bottom", "bottom-left", "bottom-right", "top", "top-left", "top-right"
+            ]
+        ] = None,
+        font_size: typing.Optional[int] = None,
+    ) -> None:
+        """Screencast.show_actions
+
+        Enables visual annotations on interacted elements. Returns a disposable that stops showing actions when disposed.
+
+        Parameters
+        ----------
+        duration : Union[float, None]
+            How long each annotation is displayed in milliseconds. Defaults to `500`.
+        position : Union["bottom", "bottom-left", "bottom-right", "top", "top-left", "top-right", None]
+            Position of the action title overlay. Defaults to `"top-right"`.
+        font_size : Union[int, None]
+            Font size of the action title in pixels. Defaults to `24`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.show_actions(
+                    duration=duration, position=position, fontSize=font_size
+                )
+            )
+        )
+
+    def hide_actions(self) -> None:
+        """Screencast.hide_actions
+
+        Removes action decorations.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.hide_actions()))
+
+    def show_overlay(
+        self, html: str, *, duration: typing.Optional[float] = None
+    ) -> None:
+        """Screencast.show_overlay
+
+        Adds an overlay with the given HTML content. The overlay is displayed on top of the page until removed. Returns a
+        disposable that removes the overlay when disposed.
+
+        Parameters
+        ----------
+        html : str
+            HTML content for the overlay.
+        duration : Union[float, None]
+            Duration in milliseconds after which the overlay is automatically removed. Overlay stays until dismissed if not
+            provided.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.show_overlay(html=html, duration=duration))
+        )
+
+    def show_chapter(
+        self,
+        title: str,
+        *,
+        description: typing.Optional[str] = None,
+        duration: typing.Optional[float] = None,
+    ) -> None:
+        """Screencast.show_chapter
+
+        Shows a chapter overlay with a title and optional description, centered on the page with a blurred backdrop. Useful
+        for narrating video recordings. The overlay is removed after the specified duration, or 2000ms.
+
+        Parameters
+        ----------
+        title : str
+            Title text displayed prominently in the overlay.
+        description : Union[str, None]
+            Optional description text displayed below the title.
+        duration : Union[float, None]
+            Duration in milliseconds after which the overlay is automatically removed. Defaults to `2000`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.show_chapter(
+                    title=title, description=description, duration=duration
+                )
+            )
+        )
+
+    def show_overlays(self) -> None:
+        """Screencast.show_overlays
+
+        Shows overlays.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.show_overlays()))
+
+    def hide_overlays(self) -> None:
+        """Screencast.hide_overlays
+
+        Hides overlays without removing them.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.hide_overlays()))
+
+
+mapping.register(ScreencastImpl, Screencast)
+
+
 class Video(SyncBase):
 
     def path(self) -> pathlib.Path:
@@ -8005,7 +8298,8 @@ def request(self) -> "APIRequestContext":
     def video(self) -> typing.Optional["Video"]:
         """Page.video
 
-        Video object associated with this page.
+        Video object associated with this page. Can be used to access the video file when using the `recordVideo` context
+        option.
 
         Returns
         -------
@@ -8013,6 +8307,20 @@ def video(self) -> typing.Optional["Video"]:
         """
         return mapping.from_impl_nullable(self._impl_obj.video)
 
+    @property
+    def screencast(self) -> "Screencast":
+        """Page.screencast
+
+        `Screencast` object associated with this page.
+
+        **Usage**
+
+        Returns
+        -------
+        Screencast
+        """
+        return mapping.from_impl(self._impl_obj.screencast)
+
     def opener(self) -> typing.Optional["Page"]:
         """Page.opener
 
@@ -9175,7 +9483,7 @@ def wait_for_url(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -9553,6 +9861,8 @@ def handle_route(route: Route):
         page.route(\"/api/**\", handle_route)
         ```
 
+        If a request matches multiple registered routes, the most recently registered route takes precedence.
+
         Page routes take precedence over browser context routes (set up with `browser_context.route()`) when request
         matches both handlers.
 
@@ -9600,7 +9910,7 @@ def unroute(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while routing.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
             Optional handler function to route the request.
         """
@@ -9847,6 +10157,39 @@ def title(self) -> str:
 
         return mapping.from_maybe_impl(self._sync(self._impl_obj.title()))
 
+    def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        depth: typing.Optional[int] = None,
+        mode: typing.Optional[Literal["ai", "default"]] = None,
+    ) -> str:
+        """Page.aria_snapshot
+
+        Captures the aria snapshot of the page. Read more about [aria snapshots](https://playwright.dev/python/docs/aria-snapshots).
+
+        Parameters
+        ----------
+        timeout : Union[float, None]
+            Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
+            be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+        depth : Union[int, None]
+            When specified, limits the depth of the snapshot.
+        mode : Union["ai", "default", None]
+            When set to `"ai"`, returns a snapshot optimized for AI consumption: including element references like `[ref=e2]`
+            and snapshots of `<iframe>`s. Defaults to `"default"`.
+
+        Returns
+        -------
+        str
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(
+                self._impl_obj.aria_snapshot(timeout=timeout, depth=depth, mode=mode)
+            )
+        )
+
     def close(
         self,
         *,
@@ -10480,7 +10823,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -10580,7 +10923,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         page.get_by_test_id(\"directions\").click()
@@ -11926,7 +12269,7 @@ def expect_navigation(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str, None]
-            A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation. Note that if
+            A glob pattern, regex pattern, or predicate receiving [URL] to match while waiting for the navigation. Note that if
             the parameter is a string without wildcard characters, the method will wait for navigation to URL that is exactly
             equal to the string.
         wait_until : Union["commit", "domcontentloaded", "load", "networkidle", None]
@@ -12401,29 +12744,96 @@ def requests(self) -> typing.List["Request"]:
 
         return mapping.from_impl_list(self._sync(self._impl_obj.requests()))
 
-    def console_messages(self) -> typing.List["ConsoleMessage"]:
+    def console_messages(
+        self, *, filter: typing.Optional[Literal["all", "since-navigation"]] = None
+    ) -> typing.List["ConsoleMessage"]:
         """Page.console_messages
 
         Returns up to (currently) 200 last console messages from this page. See `page.on('console')` for more details.
 
+        Parameters
+        ----------
+        filter : Union["all", "since-navigation", None]
+            Controls which messages are returned:
+
         Returns
         -------
         List[ConsoleMessage]
         """
 
-        return mapping.from_impl_list(self._sync(self._impl_obj.console_messages()))
+        return mapping.from_impl_list(
+            self._sync(self._impl_obj.console_messages(filter=filter))
+        )
 
-    def page_errors(self) -> typing.List["Error"]:
+    def page_errors(
+        self, *, filter: typing.Optional[Literal["all", "since-navigation"]] = None
+    ) -> typing.List["Error"]:
         """Page.page_errors
 
         Returns up to (currently) 200 last page errors from this page. See `page.on('page_error')` for more details.
 
+        Parameters
+        ----------
+        filter : Union["all", "since-navigation", None]
+            Controls which errors are returned:
+
         Returns
         -------
         List[Error]
         """
 
-        return mapping.from_impl_list(self._sync(self._impl_obj.page_errors()))
+        return mapping.from_impl_list(
+            self._sync(self._impl_obj.page_errors(filter=filter))
+        )
+
+    def clear_console_messages(self) -> None:
+        """Page.clear_console_messages
+
+        Clears all stored console messages from this page. Subsequent calls to `page.console_messages()` will only
+        return messages logged after the clear.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.clear_console_messages())
+        )
+
+    def clear_page_errors(self) -> None:
+        """Page.clear_page_errors
+
+        Clears all stored page errors from this page. Subsequent calls to `page.page_errors()` will only return
+        errors thrown after the clear.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.clear_page_errors()))
+
+    def pick_locator(self) -> "Locator":
+        """Page.pick_locator
+
+        Enters pick locator mode where hovering over page elements highlights them and shows the corresponding locator.
+        Once the user clicks an element, the mode is deactivated and the `Locator` for the picked element is returned.
+
+        **Usage**
+
+        ```py
+        locator = page.pick_locator()
+        print(locator)
+        ```
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._sync(self._impl_obj.pick_locator()))
+
+    def cancel_pick_locator(self) -> None:
+        """Page.cancel_pick_locator
+
+        Cancels an ongoing `page.pick_locator()` call by deactivating pick locator mode. If no pick locator mode is
+        active, this method is a no-op.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.cancel_pick_locator()))
 
 
 mapping.register(PageImpl, Page)
@@ -12804,6 +13214,18 @@ def tracing(self) -> "Tracing":
         """
         return mapping.from_impl(self._impl_obj.tracing)
 
+    @property
+    def debugger(self) -> "Debugger":
+        """BrowserContext.debugger
+
+        Debugger allows to pause and resume the execution.
+
+        Returns
+        -------
+        Debugger
+        """
+        return mapping.from_impl(self._impl_obj.debugger)
+
     @property
     def request(self) -> "APIRequestContext":
         """BrowserContext.request
@@ -12997,6 +13419,7 @@ def grant_permissions(
             - `'notifications'`
             - `'payment-handler'`
             - `'storage-access'`
+            - `'screen-wake-lock'`
         origin : Union[str, None]
             The [origin] to grant permissions to, e.g. "https://example.com".
         """
@@ -13353,7 +13776,7 @@ def unroute(
         Parameters
         ----------
         url : Union[Callable[[str], bool], Pattern[str], str]
-            A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with
+            A glob pattern, regex pattern, or predicate receiving [URL] used to register a routing with
             `browser_context.route()`.
         handler : Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
             Optional handler function used to register a routing with `browser_context.route()`.
@@ -13536,6 +13959,18 @@ def expect_event(
             ).future,
         )
 
+    def is_closed(self) -> bool:
+        """BrowserContext.is_closed
+
+        Indicates that the browser context is in the process of closing or has already been closed.
+
+        Returns
+        -------
+        bool
+        """
+
+        return mapping.from_maybe_impl(self._impl_obj.is_closed())
+
     def close(self, *, reason: typing.Optional[str] = None) -> None:
         """BrowserContext.close
 
@@ -13581,6 +14016,33 @@ def storage_state(
             self._sync(self._impl_obj.storage_state(path=path, indexedDB=indexed_db))
         )
 
+    def set_storage_state(
+        self, storage_state: typing.Union[StorageState, str, pathlib.Path]
+    ) -> None:
+        """BrowserContext.set_storage_state
+
+        Clears the existing cookies, local storage and IndexedDB entries for all origins and sets the new storage state.
+
+        **Usage**
+
+        ```py
+        # Load storage state from a file and apply it to the context.
+        context.set_storage_state(\"state.json\")
+        ```
+
+        Parameters
+        ----------
+        storage_state : Union[pathlib.Path, str, {cookies: Sequence[{name: str, value: str, domain: str, path: str, expires: float, httpOnly: bool, secure: bool, sameSite: Union["Lax", "None", "Strict"]}], origins: Sequence[{origin: str, localStorage: Sequence[{name: str, value: str}]}]}]
+            Learn more about [storage state and auth](../auth.md).
+
+            Populates context with given storage state. This option can be used to initialize context with logged-in
+            information obtained via `browser_context.storage_state()`.
+        """
+
+        return mapping.from_maybe_impl(
+            self._sync(self._impl_obj.set_storage_state(storageState=storage_state))
+        )
+
     def wait_for_event(
         self,
         event: str,
@@ -13710,6 +14172,34 @@ def new_cdp_session(self, page: typing.Union["Page", "Frame"]) -> "CDPSession":
 
 class CDPSession(SyncBase):
 
+    @typing.overload
+    def on(
+        self, event: Literal["close"], f: typing.Callable[["CDPSession"], "None"]
+    ) -> None:
+        """
+        Emitted when the session is closed, either because the target was closed or `session.detach()` was called.
+        """
+
+    @typing.overload
+    def on(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def on(self, event: str, f: typing.Callable[..., None]) -> None:
+        return super().on(event=event, f=f)
+
+    @typing.overload
+    def once(
+        self, event: Literal["close"], f: typing.Callable[["CDPSession"], "None"]
+    ) -> None:
+        """
+        Emitted when the session is closed, either because the target was closed or `session.detach()` was called.
+        """
+
+    @typing.overload
+    def once(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def once(self, event: str, f: typing.Callable[..., None]) -> None:
+        return super().once(event=event, f=f)
+
     def send(
         self, method: str, params: typing.Optional[typing.Dict] = None
     ) -> typing.Dict:
@@ -13748,6 +14238,7 @@ def detach(self) -> None:
 
 class Browser(SyncContextManager):
 
+    @typing.overload
     def on(
         self, event: Literal["disconnected"], f: typing.Callable[["Browser"], "None"]
     ) -> None:
@@ -13756,8 +14247,14 @@ def on(
         following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
+
+    @typing.overload
+    def on(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def on(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().on(event=event, f=f)
 
+    @typing.overload
     def once(
         self, event: Literal["disconnected"], f: typing.Callable[["Browser"], "None"]
     ) -> None:
@@ -13766,6 +14263,11 @@ def once(
         following:
         - Browser application is closed or crashed.
         - The `browser.close()` method was called."""
+
+    @typing.overload
+    def once(self, event: str, f: typing.Callable[..., None]) -> None: ...
+
+    def once(self, event: str, f: typing.Callable[..., None]) -> None:
         return super().once(event=event, f=f)
 
     @property
@@ -14352,6 +14854,51 @@ def new_browser_cdp_session(self) -> "CDPSession":
 
         return mapping.from_impl(self._sync(self._impl_obj.new_browser_cdp_session()))
 
+    def bind(
+        self,
+        title: str,
+        *,
+        workspace_dir: typing.Optional[str] = None,
+        host: typing.Optional[str] = None,
+        port: typing.Optional[int] = None,
+    ) -> BrowserBindResult:
+        """Browser.bind
+
+        Binds the browser to a named pipe or web socket, making it available for other clients to connect to.
+
+        Parameters
+        ----------
+        title : str
+            Title of the browser server, used for identification.
+        workspace_dir : Union[str, None]
+            Working directory associated with this browser server.
+        host : Union[str, None]
+            Host to bind the web socket server to. When specified, a web socket server is created instead of a named pipe.
+        port : Union[int, None]
+            Port to bind the web socket server to. When specified, a web socket server is created instead of a named pipe. Use
+            `0` to let the OS pick an available port.
+
+        Returns
+        -------
+        {endpoint: str}
+        """
+
+        return mapping.from_impl(
+            self._sync(
+                self._impl_obj.bind(
+                    title=title, workspaceDir=workspace_dir, host=host, port=port
+                )
+            )
+        )
+
+    def unbind(self) -> None:
+        """Browser.unbind
+
+        Unbinds the browser server previously bound with `browser.bind()`.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.unbind()))
+
     def start_tracing(
         self,
         *,
@@ -14467,6 +15014,7 @@ def launch(
         downloads_path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         slow_mo: typing.Optional[float] = None,
         traces_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        artifacts_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
@@ -14548,6 +15096,10 @@ def launch(
             on.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
+        artifacts_dir : Union[pathlib.Path, str, None]
+            If specified, artifacts (traces, videos, downloads, HAR files, etc.) are saved into this directory. The directory
+            is not cleaned up when the browser closes. If not specified, a temporary directory is used and cleaned up when the
+            browser closes.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
@@ -14579,6 +15131,7 @@ def launch(
                     downloadsPath=downloads_path,
                     slowMo=slow_mo,
                     tracesDir=traces_dir,
+                    artifactsDir=artifacts_dir,
                     chromiumSandbox=chromium_sandbox,
                     firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
                 )
@@ -14631,6 +15184,7 @@ def launch_persistent_context(
         contrast: typing.Optional[Literal["more", "no-preference", "null"]] = None,
         accept_downloads: typing.Optional[bool] = None,
         traces_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
+        artifacts_dir: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         chromium_sandbox: typing.Optional[bool] = None,
         firefox_user_prefs: typing.Optional[
             typing.Dict[str, typing.Union[str, float, bool]]
@@ -14785,6 +15339,10 @@ def launch_persistent_context(
             Whether to automatically download all the attachments. Defaults to `true` where all the downloads are accepted.
         traces_dir : Union[pathlib.Path, str, None]
             If specified, traces are saved into this directory.
+        artifacts_dir : Union[pathlib.Path, str, None]
+            If specified, artifacts (traces, videos, downloads, HAR files, etc.) are saved into this directory. The directory
+            is not cleaned up when the browser closes. If not specified, a temporary directory is used and cleaned up when the
+            browser closes.
         chromium_sandbox : Union[bool, None]
             Enable Chromium sandboxing. Defaults to `false`.
         firefox_user_prefs : Union[Dict[str, Union[bool, float, str]], None]
@@ -14897,6 +15455,7 @@ def launch_persistent_context(
                     contrast=contrast,
                     acceptDownloads=accept_downloads,
                     tracesDir=traces_dir,
+                    artifactsDir=artifacts_dir,
                     chromiumSandbox=chromium_sandbox,
                     firefoxUserPrefs=mapping.to_impl(firefox_user_prefs),
                     recordHarPath=record_har_path,
@@ -14979,7 +15538,7 @@ def connect_over_cdp(
 
     def connect(
         self,
-        ws_endpoint: str,
+        endpoint: str,
         *,
         timeout: typing.Optional[float] = None,
         slow_mo: typing.Optional[float] = None,
@@ -14995,7 +15554,7 @@ def connect(
 
         Parameters
         ----------
-        ws_endpoint : str
+        endpoint : str
             A Playwright browser websocket endpoint to connect to. You obtain this endpoint via `BrowserServer.wsEndpoint`.
         timeout : Union[float, None]
             Maximum time in milliseconds to wait for the connection to be established. Defaults to `0` (no timeout).
@@ -15027,7 +15586,7 @@ def connect(
         return mapping.from_impl(
             self._sync(
                 self._impl_obj.connect(
-                    wsEndpoint=ws_endpoint,
+                    endpoint=endpoint,
                     timeout=timeout,
                     slowMo=slow_mo,
                     headers=mapping.to_impl(headers),
@@ -15173,6 +15732,7 @@ def start(
         snapshots: typing.Optional[bool] = None,
         screenshots: typing.Optional[bool] = None,
         sources: typing.Optional[bool] = None,
+        live: typing.Optional[bool] = None,
     ) -> None:
         """Tracing.start
 
@@ -15212,6 +15772,10 @@ def start(
             Whether to capture screenshots during tracing. Screenshots are used to build a timeline preview.
         sources : Union[bool, None]
             Whether to include source files for trace actions.
+        live : Union[bool, None]
+            When enabled, the trace is written to an unarchived file that is updated in real time as actions occur, instead of
+            caching changes and archiving them into a zip file at the end. This is useful for live trace viewing during test
+            execution.
         """
 
         return mapping.from_maybe_impl(
@@ -15222,6 +15786,7 @@ def start(
                     snapshots=snapshots,
                     screenshots=screenshots,
                     sources=sources,
+                    live=live,
                 )
             )
         )
@@ -16327,7 +16892,7 @@ def get_by_role(
         <button>Submit</button>
         ```
 
-        You can locate each element by it's implicit role:
+        You can locate each element by its implicit role:
 
         ```py
         expect(page.get_by_role(\"heading\", name=\"Sign up\")).to_be_visible()
@@ -16427,7 +16992,7 @@ def get_by_test_id(
         <button data-testid=\"directions\">Itinéraire</button>
         ```
 
-        You can locate the element by it's test id:
+        You can locate the element by its test id:
 
         ```py
         page.get_by_test_id(\"directions\").click()
@@ -17473,7 +18038,13 @@ def screenshot(
             )
         )
 
-    def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
+    def aria_snapshot(
+        self,
+        *,
+        timeout: typing.Optional[float] = None,
+        depth: typing.Optional[int] = None,
+        mode: typing.Optional[Literal["ai", "default"]] = None,
+    ) -> str:
         """Locator.aria_snapshot
 
         Captures the aria snapshot of the given element. Read more about [aria snapshots](https://playwright.dev/python/docs/aria-snapshots) and
@@ -17513,11 +18084,20 @@ def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
             - link \"About\"
         ```
 
+        An AI-optimized snapshot, controlled by `mode`, is different from a default snapshot:
+        1. Includes element references `[ref=e2]`. 2. Does not wait for an element matching the locator, and throws when
+           no elements match. 3. Includes snapshots of `<iframe>`s inside the target.
+
         Parameters
         ----------
         timeout : Union[float, None]
             Maximum time in milliseconds. Defaults to `30000` (30 seconds). Pass `0` to disable timeout. The default value can
             be changed by using the `browser_context.set_default_timeout()` or `page.set_default_timeout()` methods.
+        depth : Union[int, None]
+            When specified, limits the depth of the snapshot.
+        mode : Union["ai", "default", None]
+            When set to `"ai"`, returns a snapshot optimized for AI consumption. Defaults to `"default"`. See details for more
+            information.
 
         Returns
         -------
@@ -17525,9 +18105,25 @@ def aria_snapshot(self, *, timeout: typing.Optional[float] = None) -> str:
         """
 
         return mapping.from_maybe_impl(
-            self._sync(self._impl_obj.aria_snapshot(timeout=timeout))
+            self._sync(
+                self._impl_obj.aria_snapshot(timeout=timeout, depth=depth, mode=mode)
+            )
         )
 
+    def normalize(self) -> "Locator":
+        """Locator.normalize
+
+        Returns a new locator that uses best practices for referencing the matched element, prioritizing test ids, aria
+        roles, and other user-facing attributes over CSS selectors. This is useful for converting implementation-detail
+        selectors into more resilient, human-readable locators.
+
+        Returns
+        -------
+        Locator
+        """
+
+        return mapping.from_impl(self._sync(self._impl_obj.normalize()))
+
     def scroll_into_view_if_needed(
         self, *, timeout: typing.Optional[float] = None
     ) -> None:
@@ -18306,7 +18902,7 @@ def delete(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18389,7 +18985,7 @@ def head(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18472,7 +19068,7 @@ def get(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18567,7 +19163,7 @@ def patch(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18650,7 +19246,7 @@ def put(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18733,7 +19329,7 @@ def post(
             typing.Union[typing.Dict[str, typing.Union[str, float, bool]], str]
         ] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
@@ -18848,7 +19444,7 @@ def fetch(
         ] = None,
         method: typing.Optional[str] = None,
         headers: typing.Optional[typing.Dict[str, str]] = None,
-        data: typing.Optional[typing.Union[typing.Any, str, bytes]] = None,
+        data: typing.Optional[typing.Union[typing.Any, bytes, str]] = None,
         form: typing.Optional[typing.Dict[str, typing.Union[str, float, bool]]] = None,
         multipart: typing.Optional[
             typing.Dict[str, typing.Union[bytes, bool, float, str, FilePayload]]
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index a842a1aad..2e2264b06 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -207,34 +207,34 @@ def print_events(self, class_name: str) -> None:
         if events:
             doc = []
             for event_type in ["on", "once"]:
+                return_type = (
+                    "typing.Union[typing.Awaitable[None], None]"
+                    if self.is_async
+                    else "None"
+                )
                 for event in events:
-                    return_type = (
-                        "typing.Union[typing.Awaitable[None], None]"
-                        if self.is_async
-                        else "None"
-                    )
                     func_arg = self.serialize_doc_type(event["type"], "")
                     if func_arg.startswith("{"):
                         func_arg = "typing.Dict"
                     if "Union[" in func_arg:
                         func_arg = func_arg.replace("Union[", "typing.Union[")
-                    if len(events) > 1:
-                        doc.append("    @typing.overload")
-                    impl = ""
-                    if len(events) == 1:
-                        impl = f"        return super().{event_type}(event=event,f=f)"
+                    doc.append("    @typing.overload")
                     doc.append(
                         f"    def {event_type}(self, event: Literal['{event['name'].lower()}'], f: typing.Callable[['{func_arg}'], '{return_type}']) -> None:"
                     )
                     doc.append(
                         f'        """{self.beautify_method_comment(event["comment"], " " * 8)}"""'
                     )
-                    doc.append(impl)
-                if len(events) > 1:
+                if len(events) == 1:
+                    doc.append("    @typing.overload")
                     doc.append(
-                        f"    def {event_type}(self, event: str, f: typing.Callable[...,{return_type}]) -> None:"
+                        f"    def {event_type}(self, event: str, f: typing.Callable[...,{return_type}]) -> None: ..."
                     )
-                    doc.append(f"        return super().{event_type}(event=event,f=f)")
+                    doc.append("")
+                doc.append(
+                    f"    def {event_type}(self, event: str, f: typing.Callable[...,{return_type}]) -> None:"
+                )
+                doc.append(f"        return super().{event_type}(event=event,f=f)")
             print("\n".join(doc))
 
     def indent_paragraph(self, p: str, indent: str) -> str:
@@ -437,6 +437,8 @@ def serialize_doc_type(self, type: Any, direction: str) -> str:
 
     def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
         if type["name"] == "Promise":
+            if "templates" not in type:
+                return "Any"
             type = type["templates"][0]
 
         if "union" in type:
@@ -506,7 +508,7 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
             return "str"
         if type_name == "RegExp":
             return "Pattern[str]"
-        if type_name == "null":
+        if type_name == "null" or type_name == "void":
             return "None"
         if type_name == "EvaluationArgument":
             return "Dict"
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 3d2f45156..eea3be7bd 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -29,6 +29,7 @@
 from playwright._impl._cdp_session import CDPSession
 from playwright._impl._clock import Clock
 from playwright._impl._console_message import ConsoleMessage
+from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
 from playwright._impl._download import Download
 from playwright._impl._element_handle import ElementHandle
@@ -48,6 +49,7 @@
 )
 from playwright._impl._page import Page, Worker
 from playwright._impl._playwright import Playwright
+from playwright._impl._screencast import Screencast
 from playwright._impl._selectors import Selectors
 from playwright._impl._tracing import Tracing
 from playwright._impl._video import Video
@@ -224,13 +226,14 @@ def return_value(value: Any) -> List[str]:
 from typing import Literal
 
 
-from playwright._impl._api_structures import Cookie, SetCookieParam, FloatRect, FilePayload, Geolocation, HttpCredentials, PdfMargins, Position, ProxySettings, ResourceTiming, SourceLocation, StorageState, ClientCertificate, ViewportSize, RemoteAddr, SecurityDetails, RequestSizes, NameValue, TracingGroupLocation
+from playwright._impl._api_structures import Cookie, SetCookieParam, FloatRect, FilePayload, Geolocation, HttpCredentials, PdfMargins, Position, ProxySettings, ResourceTiming, SourceLocation, StorageState, ClientCertificate, ViewportSize, RemoteAddr, SecurityDetails, RequestSizes, NameValue, TracingGroupLocation, DebuggerLocation, DebuggerPausedDetails, ScreencastFrame, BrowserBindResult
 from playwright._impl._browser import Browser as BrowserImpl
 from playwright._impl._browser_context import BrowserContext as BrowserContextImpl
 from playwright._impl._browser_type import BrowserType as BrowserTypeImpl
 from playwright._impl._clock import Clock as ClockImpl
 from playwright._impl._cdp_session import CDPSession as CDPSessionImpl
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
+from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
@@ -243,6 +246,7 @@ def return_value(value: Any) -> List[str]:
 from playwright._impl._web_error import WebError as WebErrorImpl
 from playwright._impl._playwright import Playwright as PlaywrightImpl
 from playwright._impl._selectors import Selectors as SelectorsImpl
+from playwright._impl._screencast import Screencast as ScreencastImpl
 from playwright._impl._video import Video as VideoImpl
 from playwright._impl._tracing import Tracing as TracingImpl
 from playwright._impl._locator import Locator as LocatorImpl, FrameLocator as FrameLocatorImpl
@@ -270,8 +274,10 @@ def return_value(value: Any) -> List[str]:
     Selectors,
     Clock,
     ConsoleMessage,
+    Debugger,
     Dialog,
     Download,
+    Screencast,
     Video,
     Page,
     WebError,
diff --git a/setup.py b/setup.py
index 5a8229db1..3bfa8d6f2 100644
--- a/setup.py
+++ b/setup.py
@@ -21,7 +21,7 @@
 import zipfile
 from typing import Dict
 
-driver_version = "1.58.0"
+driver_version = "1.59.1"
 
 base_wheel_bundles = [
     {
diff --git a/tests/async/test_browser.py b/tests/async/test_browser.py
index e23b3439b..84e9a4844 100644
--- a/tests/async/test_browser.py
+++ b/tests/async/test_browser.py
@@ -53,3 +53,17 @@ async def test_should_return_browser_type(
     browser: Browser, browser_type: BrowserType
 ) -> None:
     assert browser.browser_type is browser_type
+
+
+async def test_bind_should_return_endpoint_and_allow_unbind(
+    browser_type: BrowserType,
+) -> None:
+    browser = await browser_type.launch()
+    try:
+        result = await browser.bind("test-server")
+        assert "endpoint" in result
+        assert isinstance(result["endpoint"], str)
+        assert len(result["endpoint"]) > 0
+        await browser.unbind()
+    finally:
+        await browser.close()
diff --git a/tests/async/test_browsercontext.py b/tests/async/test_browsercontext.py
index ba53b6f95..6b19791b1 100644
--- a/tests/async/test_browsercontext.py
+++ b/tests/async/test_browsercontext.py
@@ -168,6 +168,13 @@ async def test_close_should_be_callable_twice(browser: Browser) -> None:
     await context.close()
 
 
+async def test_is_closed_should_reflect_state(browser: Browser) -> None:
+    context = await browser.new_context()
+    assert context.is_closed() is False
+    await context.close()
+    assert context.is_closed() is True
+
+
 async def test_user_agent_should_work(browser: Browser, server: Server) -> None:
     async def baseline() -> None:
         context = await browser.new_context()
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index 5004844ff..17df45a0e 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -133,6 +133,32 @@ async def test_should_round_trip_through_the_file(
     await context2.close()
 
 
+async def test_set_storage_state_should_apply_state_to_existing_context(
+    browser: Browser,
+) -> None:
+    src = await browser.new_context()
+    src_page = await src.new_page()
+    await src_page.route(
+        "**/*",
+        lambda route: asyncio.create_task(route.fulfill(body="<html></html>")),
+    )
+    await src_page.goto("https://www.example.com")
+    await src_page.evaluate('() => localStorage.setItem("k", "v")')
+    state = await src.storage_state()
+    await src.close()
+
+    dst = await browser.new_context()
+    dst_page = await dst.new_page()
+    await dst_page.route(
+        "**/*",
+        lambda route: asyncio.create_task(route.fulfill(body="<html></html>")),
+    )
+    await dst.set_storage_state(state)
+    await dst_page.goto("https://www.example.com")
+    assert await dst_page.evaluate('() => localStorage.getItem("k")') == "v"
+    await dst.close()
+
+
 async def test_should_serialiser_storage_state_with_lone_surrogates(
     page: Page, context: BrowserContext, server: Server
 ) -> None:
diff --git a/tests/async/test_click.py b/tests/async/test_click.py
index 8fb06ec38..144823e6d 100644
--- a/tests/async/test_click.py
+++ b/tests/async/test_click.py
@@ -435,32 +435,30 @@ async def test_click_the_button_with_device_scale_factor_set(
 
 
 async def test_click_the_button_with_px_border_with_offset(
-    page: Page, server: Server, is_webkit: bool
+    page: Page, server: Server
 ) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "button => button.style.borderWidth = '8px'")
     await page.click("button", position={"x": 20, "y": 10})
     assert await page.evaluate("result") == "Clicked"
-    # Safari reports border-relative offsetX/offsetY.
-    assert await page.evaluate("offsetX") == 20 + 8 if is_webkit else 20
-    assert await page.evaluate("offsetY") == 10 + 8 if is_webkit else 10
+    assert await page.evaluate("offsetX") == 20
+    assert await page.evaluate("offsetY") == 10
 
 
 async def test_click_the_button_with_em_border_with_offset(
-    page: Page, server: Server, is_webkit: bool
+    page: Page, server: Server
 ) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "button => button.style.borderWidth = '2em'")
     await page.eval_on_selector("button", "button => button.style.fontSize = '12px'")
     await page.click("button", position={"x": 20, "y": 10})
     assert await page.evaluate("result") == "Clicked"
-    # Safari reports border-relative offsetX/offsetY.
-    assert await page.evaluate("offsetX") == 12 * 2 + 20 if is_webkit else 20
-    assert await page.evaluate("offsetY") == 12 * 2 + 10 if is_webkit else 10
+    assert await page.evaluate("offsetX") == 20
+    assert await page.evaluate("offsetY") == 10
 
 
 async def test_click_a_very_large_button_with_offset(
-    page: Page, server: Server, is_webkit: bool
+    page: Page, server: Server
 ) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector("button", "button => button.style.borderWidth = '8px'")
@@ -469,13 +467,12 @@ async def test_click_a_very_large_button_with_offset(
     )
     await page.click("button", position={"x": 1900, "y": 1910})
     assert await page.evaluate("() => window.result") == "Clicked"
-    # Safari reports border-relative offsetX/offsetY.
-    assert await page.evaluate("() => offsetX") == 1900 + 8 if is_webkit else 1900
-    assert await page.evaluate("() => offsetY") == 1910 + 8 if is_webkit else 1910
+    assert await page.evaluate("() => offsetX") == 1900
+    assert await page.evaluate("() => offsetY") == 1910
 
 
 async def test_click_a_button_in_scrolling_container_with_offset(
-    page: Page, server: Server, is_webkit: bool
+    page: Page, server: Server
 ) -> None:
     await page.goto(server.PREFIX + "/input/button.html")
     await page.eval_on_selector(
@@ -495,9 +492,8 @@ async def test_click_a_button_in_scrolling_container_with_offset(
 
     await page.click("button", position={"x": 1900, "y": 1910})
     assert await page.evaluate("window.result") == "Clicked"
-    # Safari reports border-relative offsetX/offsetY.
-    assert await page.evaluate("offsetX") == 1900 + 8 if is_webkit else 1900
-    assert await page.evaluate("offsetY") == 1910 + 8 if is_webkit else 1910
+    assert await page.evaluate("offsetX") == 1900
+    assert await page.evaluate("offsetY") == 1910
 
 
 @pytest.mark.skip_browser("firefox")
diff --git a/tests/async/test_debugger.py b/tests/async/test_debugger.py
new file mode 100644
index 000000000..9613fcb34
--- /dev/null
+++ b/tests/async/test_debugger.py
@@ -0,0 +1,43 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import asyncio
+
+from playwright.async_api import BrowserContext, Page
+from tests.server import Server
+
+
+async def test_should_expose_debugger_property(context: BrowserContext) -> None:
+    assert context.debugger is context.debugger
+    assert context.debugger.paused_details is None
+
+
+async def test_should_pause_and_resume(
+    context: BrowserContext, page: Page, server: Server
+) -> None:
+    paused_event = asyncio.Event()
+    context.debugger.on("pausedstatechanged", lambda: paused_event.set())
+
+    await context.debugger.request_pause()
+    next_call = asyncio.create_task(page.goto(server.EMPTY_PAGE))
+
+    await asyncio.wait_for(paused_event.wait(), timeout=5)
+    assert context.debugger.paused_details is not None
+
+    paused_event.clear()
+    await context.debugger.resume()
+    await asyncio.wait_for(paused_event.wait(), timeout=5)
+    assert context.debugger.paused_details is None
+
+    await next_call
diff --git a/tests/async/test_dialog.py b/tests/async/test_dialog.py
index 7ad32f8bc..a25c6468f 100644
--- a/tests/async/test_dialog.py
+++ b/tests/async/test_dialog.py
@@ -102,3 +102,15 @@ async def test_should_auto_dismiss_the_alert_without_listeners(page: Page) -> No
     )
     await page.click("div")
     assert await page.evaluate('"window._clicked"')
+
+
+async def test_dismiss_should_swallow_target_closed_error(browser: Browser) -> None:
+    context = await browser.new_context()
+    page = await context.new_page()
+    async with page.expect_event("dialog") as dialog_info:
+        await page.evaluate("() => setTimeout(() => alert('hello'), 0)", None)
+    dialog = await dialog_info.value
+    await page.close()
+    # Dialog.dismiss should be a no-op once the target is closed.
+    await dialog.dismiss()
+    await context.close()
diff --git a/tests/async/test_locators.py b/tests/async/test_locators.py
index 1e49bf303..1ab16c39d 100644
--- a/tests/async/test_locators.py
+++ b/tests/async/test_locators.py
@@ -1191,3 +1191,9 @@ async def test_description_should_return_description_for_locator_with_multiple_d
     assert locator2.description == "Second description"
     locator3 = locator2.locator("button")
     assert locator3.description is None
+
+
+async def test_normalize_should_resolve_to_a_locator(page: Page) -> None:
+    await page.set_content("<button>Click me</button>")
+    normalized = await page.get_by_role("button").normalize()
+    assert await normalized.text_content() == "Click me"
diff --git a/tests/async/test_navigation.py b/tests/async/test_navigation.py
index 240aee242..a74d67533 100644
--- a/tests/async/test_navigation.py
+++ b/tests/async/test_navigation.py
@@ -801,7 +801,7 @@ async def test_wait_for_load_state_should_work_with_pages_that_have_loaded_befor
 
 
 async def test_wait_for_load_state_should_wait_for_load_state_of_empty_url_popup(
-    page: Page, is_firefox: bool
+    page: Page,
 ) -> None:
     ready_state = []
     async with page.expect_popup() as popup_info:
@@ -816,7 +816,7 @@ async def test_wait_for_load_state_should_wait_for_load_state_of_empty_url_popup
 
     popup = await popup_info.value
     await popup.wait_for_load_state()
-    assert ready_state == ["uninitialized"] if is_firefox else ["complete"]
+    assert ready_state == ["complete"]
     assert await popup.evaluate("() => document.readyState") == ready_state[0]
 
 
diff --git a/tests/async/test_page_aria_snapshot.py b/tests/async/test_page_aria_snapshot.py
index cef17cdd0..302ff37cb 100644
--- a/tests/async/test_page_aria_snapshot.py
+++ b/tests/async/test_page_aria_snapshot.py
@@ -214,3 +214,20 @@ async def test_match_values_both_against_regex_and_string(page: Page) -> None:
           - /url: /auth?r=/
       """,
     )
+
+
+async def test_should_snapshot_with_depth(page: Page) -> None:
+    await page.set_content("<ul><li><a href=about:blank>link</a></li></ul>")
+    snapshot = await page.locator("body").aria_snapshot(depth=1)
+    assert "listitem" in snapshot
+    assert "/url" not in snapshot
+
+
+async def test_page_aria_snapshot_should_work(page: Page) -> None:
+    await page.set_content("<h1>title</h1>")
+    snapshot = await page.aria_snapshot()
+    assert _unshift(snapshot) == _unshift(
+        """
+      - heading "title" [level=1]
+    """
+    )
diff --git a/tests/async/test_page_event_console.py b/tests/async/test_page_event_console.py
index 4326e1823..2b6bc5ddf 100644
--- a/tests/async/test_page_event_console.py
+++ b/tests/async/test_page_event_console.py
@@ -12,7 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright._impl._page import Page
+from playwright.async_api import Page
+from tests.server import Server
 
 
 async def test_console_messages_should_work(page: Page) -> None:
@@ -33,3 +34,32 @@ async def test_console_messages_should_work(page: Page) -> None:
     assert len(objects) >= 100, "should be at least 100 messages"
     message_count = len(messages) - len(expected)
     assert objects[message_count:] == expected, "should return last messages"
+
+
+async def test_should_have_a_timestamp(page: Page) -> None:
+    async with page.expect_console_message() as message_info:
+        await page.evaluate("() => console.log('hello')")
+    message = await message_info.value
+    assert message.timestamp > 0
+
+
+async def test_clear_console_messages_should_drop_buffered_messages(page: Page) -> None:
+    await page.evaluate("() => console.log('first')")
+    assert any(m.text == "first" for m in await page.console_messages())
+    await page.clear_console_messages()
+    assert not any(m.text == "first" for m in await page.console_messages())
+    await page.evaluate("() => console.log('second')")
+    assert any(m.text == "second" for m in await page.console_messages())
+
+
+async def test_console_messages_filter_since_navigation_drops_pre_nav_messages(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate("() => console.log('before-nav')")
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate("() => console.log('after-nav')")
+    after = await page.console_messages(filter="since-navigation")
+    texts = [m.text for m in after]
+    assert "after-nav" in texts
+    assert "before-nav" not in texts
diff --git a/tests/async/test_page_event_pageerror.py b/tests/async/test_page_event_pageerror.py
index 4914af5d1..a072f009e 100644
--- a/tests/async/test_page_event_pageerror.py
+++ b/tests/async/test_page_event_pageerror.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 from playwright.async_api import Page
+from tests.server import Server
 
 
 async def test_page_errors_should_work(page: Page) -> None:
@@ -34,3 +35,26 @@ async def test_page_errors_should_work(page: Page) -> None:
     assert len(messages) >= 100, "should be at least 100 errors"
     message_count = len(messages) - len(expected)
     assert messages[message_count:] == expected, "should return last errors"
+
+
+async def test_clear_page_errors_should_drop_buffered_errors(page: Page) -> None:
+    await page.evaluate("() => setTimeout(() => { throw new Error('first'); }, 0)")
+    await page.evaluate("() => new Promise(r => setTimeout(r, 50))")
+    assert any(e.message == "first" for e in await page.page_errors())
+    await page.clear_page_errors()
+    assert not any(e.message == "first" for e in await page.page_errors())
+
+
+async def test_page_errors_filter_since_navigation_drops_pre_nav_errors(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate("() => setTimeout(() => { throw new Error('before-nav'); }, 0)")
+    await page.evaluate("() => new Promise(r => setTimeout(r, 50))")
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate("() => setTimeout(() => { throw new Error('after-nav'); }, 0)")
+    await page.evaluate("() => new Promise(r => setTimeout(r, 50))")
+    after = await page.page_errors(filter="since-navigation")
+    messages = [e.message for e in after]
+    assert "after-nav" in messages
+    assert "before-nav" not in messages
diff --git a/tests/async/test_page_network_request.py b/tests/async/test_page_network_request.py
index 779875eda..bab4d5fd0 100644
--- a/tests/async/test_page_network_request.py
+++ b/tests/async/test_page_network_request.py
@@ -61,3 +61,24 @@ async def test_should_parse_the_data_if_content_type_is_application_x_www_form_u
     request = await request_info.value
     assert request
     assert request.post_data_json == {"foo": "bar", "baz": "123"}
+
+
+async def test_existing_response_should_return_response_after_it_is_received(
+    page: Page, server: Server
+) -> None:
+    async with page.expect_event("requestfinished") as request_finished_info:
+        await page.goto(server.EMPTY_PAGE)
+    request = await request_finished_info.value
+    assert request.existing_response is not None
+    assert request.existing_response.status == 200
+
+
+async def test_existing_response_should_return_none_before_response_arrives(
+    page: Page, server: Server
+) -> None:
+    captured = []
+    page.on("request", lambda req: captured.append(req.existing_response))
+    await page.goto(server.EMPTY_PAGE)
+    assert captured
+    # When the "request" event fires, the response has not been received yet.
+    assert captured[0] is None
diff --git a/tests/async/test_page_network_response.py b/tests/async/test_page_network_response.py
index 58988fabc..55bd5ff54 100644
--- a/tests/async/test_page_network_response.py
+++ b/tests/async/test_page_network_response.py
@@ -70,3 +70,10 @@ def handle_get(request: TestServerRequest) -> None:
         await finish_coroutine
     error = exc_info.value
     assert "closed" in error.message
+
+
+async def test_should_return_http_version(page: Page, server: Server) -> None:
+    response = await page.goto(server.EMPTY_PAGE)
+    assert response
+    http_version = await response.http_version()
+    assert http_version in ("HTTP/1.0", "HTTP/1.1", "HTTP/2.0")
diff --git a/tests/async/test_popup.py b/tests/async/test_popup.py
index ff3b346ff..3c14b87f0 100644
--- a/tests/async/test_popup.py
+++ b/tests/async/test_popup.py
@@ -15,6 +15,8 @@
 import asyncio
 from typing import List, Optional
 
+import pytest
+
 from playwright.async_api import Browser, BrowserContext, Request, Route
 from tests.server import Server
 from tests.utils import must
@@ -136,9 +138,13 @@ async def test_should_inherit_http_credentials_from_browser_context(
     await context.close()
 
 
+@pytest.mark.skip_browser("firefox")
 async def test_should_inherit_touch_support_from_browser_context(
     browser: Browser, server: Server
 ) -> None:
+    # Firefox 148+ does not expose `ontouchstart` on freshly window.open()'d
+    # popups (https://bugzilla.mozilla.org/show_bug.cgi?id=2014330);
+    # upstream marks this as fixme for the same reason.
     context = await browser.new_context(
         viewport={"width": 400, "height": 500}, has_touch=True
     )
diff --git a/tests/async/test_route_web_socket.py b/tests/async/test_route_web_socket.py
index 465832adf..da6ce8757 100644
--- a/tests/async/test_route_web_socket.py
+++ b/tests/async/test_route_web_socket.py
@@ -41,10 +41,10 @@ async def assert_equal(
 
 async def setup_ws(
     target: Union[Page, Frame],
-    port: int,
+    server: Server,
     protocol: Union[Literal["blob"], Literal["arraybuffer"]],
 ) -> None:
-    await target.goto("about:blank")
+    await target.goto(server.EMPTY_PAGE)
     await target.evaluate(
         """({ port, binaryType }) => {
     window.log = [];
@@ -65,7 +65,7 @@ async def setup_ws(
     });
     window.wsOpened = new Promise(f => window.ws.addEventListener('open', () => f()));
   }""",
-        {"port": port, "binaryType": protocol},
+        {"port": server.PORT, "binaryType": protocol},
     )
 
 
@@ -79,7 +79,7 @@ def _handle_ws(ws: WebSocketRoute) -> None:
     await page.route_web_socket(re.compile(".*"), _handle_ws)
 
     ws_task = server.wait_for_web_socket()
-    await setup_ws(page, server.PORT, "blob")
+    await setup_ws(page, server, "blob")
     ws = await ws_task
 
     route = await future
@@ -117,7 +117,7 @@ async def test_should_pattern_match(page: Page, server: Server) -> None:
     )
 
     ws_task = server.wait_for_web_socket()
-    await page.goto("about:blank")
+    await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         """async ({ port }) => {
         window.log = [];
@@ -191,7 +191,7 @@ def _once_web_socket_connection(ws: WebSocketProtocol) -> None:
 
     server.once_web_socket_connection(_once_web_socket_connection)
 
-    await setup_ws(page, server.PORT, "blob")
+    await setup_ws(page, server, "blob")
     ws = await ws_task
     await assert_equal(lambda: log, ["message: fake"])
 
@@ -285,7 +285,7 @@ def _ws_on_message(message: Union[str, bytes]) -> None:
         future.set_result(ws)
 
     await page.route_web_socket(re.compile(".*"), _handle_ws)
-    await setup_ws(page, server.PORT, "blob")
+    await setup_ws(page, server, "blob")
 
     await page.evaluate(
         """async () => {
@@ -330,7 +330,7 @@ async def _handle_ws(ws: WebSocketRoute) -> None:
         ws.on_message(lambda message: ws.send(message))
 
     await page.route_web_socket("/ws", _handle_ws)
-    await setup_ws(page, server.PORT, "blob")
+    await setup_ws(page, server, "blob")
 
     await page.evaluate(
         """async () => {
@@ -362,7 +362,7 @@ def on_message(message: Union[str, bytes]) -> None:
     # No trailing slash in the route pattern
     await page.route_web_socket(f"ws://localhost:{server.PORT}", handle_ws)
 
-    await page.goto("about:blank")
+    await page.goto(server.EMPTY_PAGE)
     await page.evaluate(
         """({ port }) => {
             window.log = [];
diff --git a/tests/async/test_screencast.py b/tests/async/test_screencast.py
new file mode 100644
index 000000000..5532f7847
--- /dev/null
+++ b/tests/async/test_screencast.py
@@ -0,0 +1,72 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import asyncio
+
+import pytest
+
+from playwright.async_api import Page, ScreencastFrame
+from tests.server import Server
+
+
+async def test_should_expose_screencast_property(page: Page) -> None:
+    assert page.screencast is page.screencast
+
+
+async def test_start_should_deliver_frames_via_callback(
+    page: Page, server: Server
+) -> None:
+    received: list = []
+    event = asyncio.Event()
+
+    def on_frame(frame: ScreencastFrame) -> None:
+        received.append(frame["data"])
+        event.set()
+
+    await page.screencast.start(on_frame=on_frame)
+    await page.goto(server.EMPTY_PAGE)
+    await page.evaluate("() => document.body.style.backgroundColor = 'red'")
+    # Force a couple of paint cycles so engines that only emit on visual change
+    # still produce a frame. Mirrors upstream `ensureSomeFrames`.
+    for _ in range(3):
+        await page.evaluate(
+            "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
+        )
+    await page.screenshot()
+    await asyncio.wait_for(event.wait(), timeout=10)
+    await page.screencast.stop()
+    assert len(received) >= 1
+    assert all(isinstance(d, bytes) and len(d) > 0 for d in received)
+
+
+async def test_starting_twice_should_throw(page: Page) -> None:
+    await page.screencast.start(on_frame=lambda f: None)
+    try:
+        with pytest.raises(Exception, match="already started"):
+            await page.screencast.start(on_frame=lambda f: None)
+    finally:
+        await page.screencast.stop()
+
+
+async def test_show_overlays_and_overlay_apis_should_not_throw(page: Page) -> None:
+    await page.screencast.start(on_frame=lambda f: None)
+    try:
+        await page.screencast.show_overlay("<div>hello</div>", duration=100)
+        await page.screencast.show_chapter("ch", description="desc", duration=100)
+        await page.screencast.hide_overlays()
+        await page.screencast.show_overlays()
+        await page.screencast.show_actions(duration=100, position="top-right")
+        await page.screencast.hide_actions()
+    finally:
+        await page.screencast.stop()
diff --git a/tests/conftest.py b/tests/conftest.py
index 2b533f15f..d12a065c0 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -22,6 +22,7 @@
 from typing import Any, Callable, Dict, Generator, List, Optional, cast
 
 import pytest
+from _pytest.terminal import TerminalReporter
 from PIL import Image
 from pixelmatch import pixelmatch
 from pixelmatch.contrib.PIL import from_PIL_to_raw_data
@@ -263,6 +264,25 @@ def kill(self) -> None:
         self.process.wait()
 
 
+_failed_node_ids: List[str] = []
+
+
+def pytest_runtest_logreport(report: pytest.TestReport) -> None:
+    if report.failed and report.when in ("setup", "call"):
+        if report.nodeid not in _failed_node_ids:
+            _failed_node_ids.append(report.nodeid)
+
+
+def pytest_terminal_summary(
+    terminalreporter: TerminalReporter, exitstatus: int, config: pytest.Config
+) -> None:
+    if not _failed_node_ids:
+        return
+    terminalreporter.write_sep("=", "Failed tests", red=True, bold=True)
+    for index, nodeid in enumerate(_failed_node_ids, 1):
+        terminalreporter.write_line(f"  {index}) {nodeid}", red=True)
+
+
 @pytest.fixture
 def launch_server(
     browser_name: str, launch_arguments: Dict, tmp_path: Path
diff --git a/tests/sync/test_debugger.py b/tests/sync/test_debugger.py
new file mode 100644
index 000000000..c6be1ec89
--- /dev/null
+++ b/tests/sync/test_debugger.py
@@ -0,0 +1,20 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from playwright.sync_api import BrowserContext
+
+
+def test_should_expose_debugger_property(context: BrowserContext) -> None:
+    assert context.debugger is context.debugger
+    assert context.debugger.paused_details is None
diff --git a/tests/sync/test_page_aria_snapshot.py b/tests/sync/test_page_aria_snapshot.py
index 17d722ae8..b2e3d81ca 100644
--- a/tests/sync/test_page_aria_snapshot.py
+++ b/tests/sync/test_page_aria_snapshot.py
@@ -214,3 +214,20 @@ def test_match_values_both_against_regex_and_string(page: Page) -> None:
           - /url: /auth?r=/
       """,
     )
+
+
+def test_should_snapshot_with_depth(page: Page) -> None:
+    page.set_content("<ul><li><a href=about:blank>link</a></li></ul>")
+    snapshot = page.locator("body").aria_snapshot(depth=1)
+    assert "listitem" in snapshot
+    assert "/url" not in snapshot
+
+
+def test_page_aria_snapshot_should_work(page: Page) -> None:
+    page.set_content("<h1>title</h1>")
+    snapshot = page.aria_snapshot()
+    assert _unshift(snapshot) == _unshift(
+        """
+      - heading "title" [level=1]
+    """
+    )
diff --git a/tests/sync/test_page_event_console.py b/tests/sync/test_page_event_console.py
index 0ab19eca7..34dd192e4 100644
--- a/tests/sync/test_page_event_console.py
+++ b/tests/sync/test_page_event_console.py
@@ -34,3 +34,16 @@ def test_console_messages_should_work(page: Page) -> None:
     assert len(objects) >= 100, "should be at least 100 messages"
     message_count = len(messages) - len(expected)
     assert objects[message_count:] == expected, "should return last messages"
+
+
+def test_should_have_a_timestamp(page: Page) -> None:
+    with page.expect_console_message() as message_info:
+        page.evaluate("() => console.log('hello')")
+    assert message_info.value.timestamp > 0
+
+
+def test_clear_console_messages_should_drop_buffered_messages(page: Page) -> None:
+    page.evaluate("() => console.log('first')")
+    assert any(m.text == "first" for m in page.console_messages())
+    page.clear_console_messages()
+    assert not any(m.text == "first" for m in page.console_messages())
diff --git a/tests/sync/test_page_network_response.py b/tests/sync/test_page_network_response.py
index 4f4213d0d..7e11f4501 100644
--- a/tests/sync/test_page_network_response.py
+++ b/tests/sync/test_page_network_response.py
@@ -64,3 +64,9 @@ def handle_get(request: http.Request) -> None:
         page_response.finished()
     error = exc_info.value
     assert "closed" in error.message
+
+
+def test_should_return_http_version(page: Page, server: Server) -> None:
+    response = page.goto(server.EMPTY_PAGE)
+    assert response
+    assert response.http_version() in ("HTTP/1.0", "HTTP/1.1", "HTTP/2.0")
diff --git a/tests/sync/test_route_web_socket.py b/tests/sync/test_route_web_socket.py
index 0cc8eda5d..6d9eb09a6 100644
--- a/tests/sync/test_route_web_socket.py
+++ b/tests/sync/test_route_web_socket.py
@@ -38,10 +38,10 @@ def assert_equal(
 
 def setup_ws(
     target: Union[Page, Frame],
-    port: int,
+    server: Server,
     protocol: Union[Literal["blob"], Literal["arraybuffer"]],
 ) -> None:
-    target.goto("about:blank")
+    target.goto(server.EMPTY_PAGE)
     target.evaluate(
         """({ port, binaryType }) => {
     window.log = [];
@@ -62,7 +62,7 @@ def setup_ws(
     });
     window.wsOpened = new Promise(f => window.ws.addEventListener('open', () => f()));
   }""",
-        {"port": port, "binaryType": protocol},
+        {"port": server.PORT, "binaryType": protocol},
     )
 
 
@@ -77,7 +77,7 @@ def _handle_ws(ws: WebSocketRoute) -> None:
     page.route_web_socket(re.compile(".*"), _handle_ws)
 
     with server.expect_websocket() as ws_task:
-        setup_ws(page, server.PORT, "blob")
+        setup_ws(page, server, "blob")
     page.evaluate("window.wsOpened")
     ws = ws_task.value
     assert route
@@ -110,7 +110,7 @@ def test_should_pattern_match(page: Page, server: Server) -> None:
         "**/mock-ws", lambda ws: ws.on_message(lambda message: ws.send("mock-response"))
     )
 
-    page.goto("about:blank")
+    page.goto(server.EMPTY_PAGE)
     with server.expect_websocket() as ws_info:
         page.evaluate(
             """async ({ port }) => {
@@ -185,7 +185,7 @@ def _once_web_socket_connection(ws: WebSocketProtocol) -> None:
     server.once_web_socket_connection(_once_web_socket_connection)
 
     with server.expect_websocket() as ws_info:
-        setup_ws(page, server.PORT, "blob")
+        setup_ws(page, server, "blob")
     page.evaluate("window.wsOpened")
     ws = ws_info.value
     assert_equal(lambda: log, ["message: fake"])
@@ -280,7 +280,7 @@ def _ws_on_message(message: Union[str, bytes]) -> None:
         route = ws
 
     page.route_web_socket(re.compile(".*"), _handle_ws)
-    setup_ws(page, server.PORT, "blob")
+    setup_ws(page, server, "blob")
 
     page.evaluate(
         """async () => {
@@ -324,7 +324,7 @@ def _handle_ws(ws: WebSocketRoute) -> None:
         ws.on_message(lambda message: ws.send(message))
 
     page.route_web_socket("/ws", _handle_ws)
-    setup_ws(page, server.PORT, "blob")
+    setup_ws(page, server, "blob")
 
     page.evaluate(
         """async () => {
@@ -357,7 +357,7 @@ def on_message(message: Union[str, bytes]) -> None:
     # No trailing slash in the route pattern
     page.route_web_socket(f"ws://localhost:{server.PORT}", handle_ws)
 
-    page.goto("about:blank")
+    page.goto(server.EMPTY_PAGE)
     page.evaluate(
         """({ port }) => {
             window.log = [];
diff --git a/tests/sync/test_screencast.py b/tests/sync/test_screencast.py
new file mode 100644
index 000000000..0dcd30530
--- /dev/null
+++ b/tests/sync/test_screencast.py
@@ -0,0 +1,53 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import time
+
+import pytest
+
+from playwright.sync_api import Page
+from tests.server import Server
+
+
+def test_should_expose_screencast_property(page: Page) -> None:
+    assert page.screencast is page.screencast
+
+
+def test_start_should_deliver_frames_via_callback(page: Page, server: Server) -> None:
+    received: list = []
+    page.screencast.start(on_frame=lambda f: received.append(f["data"]))
+    page.goto(server.EMPTY_PAGE)
+    page.evaluate("() => document.body.style.backgroundColor = 'red'")
+    # Force a couple of paint cycles so engines that only emit on visual change
+    # still produce a frame. Mirrors upstream `ensureSomeFrames`.
+    for _ in range(3):
+        page.evaluate(
+            "() => new Promise(f => requestAnimationFrame(() => requestAnimationFrame(f)))"
+        )
+    page.screenshot()
+    deadline = time.time() + 10
+    while not received and time.time() < deadline:
+        page.wait_for_timeout(100)
+    page.screencast.stop()
+    assert len(received) >= 1
+    assert all(isinstance(d, bytes) and len(d) > 0 for d in received)
+
+
+def test_starting_twice_should_throw(page: Page) -> None:
+    page.screencast.start(on_frame=lambda f: None)
+    try:
+        with pytest.raises(Exception, match="already started"):
+            page.screencast.start(on_frame=lambda f: None)
+    finally:
+        page.screencast.stop()

From d9a922d0eb68ae2255a86399cbb73d0bae3141ac Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Wed, 29 Apr 2026 11:40:43 +0200
Subject: [PATCH 08/13] feat: add AsyncContext/Disposable support (#3052)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 playwright/_impl/_browser_context.py |  22 +++--
 playwright/_impl/_disposable.py      |  93 +++++++++++++++++++++
 playwright/_impl/_object_factory.py  |   3 +
 playwright/_impl/_page.py            |  26 +++---
 playwright/_impl/_screencast.py      |  18 +++-
 playwright/_impl/_tracing.py         |   6 +-
 playwright/async_api/_generated.py   | 120 +++++++++++++++++++++------
 playwright/sync_api/_generated.py    | 120 +++++++++++++++++++++------
 scripts/documentation_provider.py    |  20 ++++-
 scripts/expected_api_mismatch.txt    |   3 +
 scripts/generate_api.py              |   3 +
 scripts/generate_async_api.py        |   5 +-
 scripts/generate_sync_api.py         |   5 +-
 tests/async/test_add_init_script.py  |  10 +++
 tests/async/test_page_route.py       |  15 ++++
 tests/sync/test_add_init_script.py   |   8 ++
 tests/sync/test_unroute_behavior.py  |  17 +++-
 17 files changed, 418 insertions(+), 76 deletions(-)
 create mode 100644 playwright/_impl/_disposable.py

diff --git a/playwright/_impl/_browser_context.py b/playwright/_impl/_browser_context.py
index 4b1c19c40..6839d7c7f 100644
--- a/playwright/_impl/_browser_context.py
+++ b/playwright/_impl/_browser_context.py
@@ -48,6 +48,7 @@
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
+from playwright._impl._disposable import Disposable, DisposableStub
 from playwright._impl._errors import Error, TargetClosedError
 from playwright._impl._event_context_manager import EventContextManagerImpl
 from playwright._impl._fetch import APIRequestContext
@@ -394,16 +395,18 @@ async def set_offline(self, offline: bool) -> None:
 
     async def add_init_script(
         self, script: str = None, path: Union[str, Path] = None
-    ) -> None:
+    ) -> Disposable:
         if path:
             script = (await async_readfile(path)).decode()
         if not isinstance(script, str):
             raise Error("Either path or script parameter must be specified")
-        await self._channel.send("addInitScript", None, dict(source=script))
+        return from_channel(
+            await self._channel.send("addInitScript", None, dict(source=script))
+        )
 
     async def expose_binding(
         self, name: str, callback: Callable, handle: bool = None
-    ) -> None:
+    ) -> Disposable:
         for page in self._pages:
             if name in page._bindings:
                 raise Error(
@@ -412,16 +415,18 @@ async def expose_binding(
         if name in self._bindings:
             raise Error(f'Function "{name}" has been already registered')
         self._bindings[name] = callback
-        await self._channel.send(
-            "exposeBinding", None, dict(name=name, needsHandle=handle or False)
+        return from_channel(
+            await self._channel.send(
+                "exposeBinding", None, dict(name=name, needsHandle=handle or False)
+            )
         )
 
-    async def expose_function(self, name: str, callback: Callable) -> None:
-        await self.expose_binding(name, lambda source, *args: callback(*args))
+    async def expose_function(self, name: str, callback: Callable) -> Disposable:
+        return await self.expose_binding(name, lambda source, *args: callback(*args))
 
     async def route(
         self, url: URLMatch, handler: RouteHandlerCallback, times: int = None
-    ) -> None:
+    ) -> DisposableStub:
         self._routes.insert(
             0,
             RouteHandler(
@@ -433,6 +438,7 @@ async def route(
             ),
         )
         await self._update_interception_patterns()
+        return DisposableStub(lambda: self.unroute(url, handler), self)
 
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
diff --git a/playwright/_impl/_disposable.py b/playwright/_impl/_disposable.py
new file mode 100644
index 000000000..c0b7e85a1
--- /dev/null
+++ b/playwright/_impl/_disposable.py
@@ -0,0 +1,93 @@
+# Copyright (c) Microsoft Corporation.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import asyncio
+import inspect
+import traceback
+from typing import Awaitable, Callable, Dict
+
+import greenlet
+
+from playwright._impl._connection import ChannelOwner
+from playwright._impl._errors import Error, is_target_closed_error
+
+
+class Disposable(ChannelOwner):
+    def __init__(
+        self, parent: ChannelOwner, type: str, guid: str, initializer: Dict
+    ) -> None:
+        super().__init__(parent, type, guid, initializer)
+
+    async def dispose(self) -> None:
+        try:
+            await self._channel.send(
+                "dispose",
+                None,
+            )
+        except Exception as e:
+            if not is_target_closed_error(e):
+                raise e
+
+    async def close(self) -> None:
+        await self.dispose()
+
+    def __repr__(self) -> str:
+        return "<Disposable>"
+
+
+class DisposableStub:
+    def __init__(
+        self,
+        dispose_fn: Callable[[], Awaitable[None]],
+        parent: ChannelOwner,
+    ) -> None:
+        self._dispose_fn = dispose_fn
+        self._loop = parent._loop
+        self._dispatcher_fiber = parent._dispatcher_fiber
+
+    async def dispose(self) -> None:
+        await self._dispose_fn()
+
+    async def __aenter__(self) -> "DisposableStub":
+        return self
+
+    async def __aexit__(self, *args: object) -> None:
+        await self.dispose()
+
+    def __enter__(self) -> "DisposableStub":
+        return self
+
+    def __exit__(self, *args: object) -> None:
+        self._sync(self.dispose())
+
+    def _sync(self, coro: object) -> object:
+        __tracebackhide__ = True
+        if self._loop.is_closed():
+            coro.close()  # type: ignore
+            raise Error("Event loop is closed! Is Playwright already stopped?")
+        g_self = greenlet.getcurrent()
+        task = self._loop.create_task(coro)  # type: ignore
+        setattr(task, "__pw_stack__", inspect.stack(0))
+        setattr(task, "__pw_stack_trace__", traceback.extract_stack(limit=10))
+        task.add_done_callback(lambda _: g_self.switch())
+        while not task.done():
+            self._dispatcher_fiber.switch()  # type: ignore
+        asyncio._set_running_loop(self._loop)
+        return task.result()
+
+    async def close(self) -> None:
+        await self.dispose()
+
+    def __repr__(self) -> str:
+        return "<Disposable>"
diff --git a/playwright/_impl/_object_factory.py b/playwright/_impl/_object_factory.py
index 7abfb4b33..7911ddb30 100644
--- a/playwright/_impl/_object_factory.py
+++ b/playwright/_impl/_object_factory.py
@@ -22,6 +22,7 @@
 from playwright._impl._connection import ChannelOwner
 from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
+from playwright._impl._disposable import Disposable
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._fetch import APIRequestContext
 from playwright._impl._frame import Frame
@@ -69,6 +70,8 @@ def create_remote_object(
         return Debugger(parent, type, guid, initializer)
     if type == "Dialog":
         return Dialog(parent, type, guid, initializer)
+    if type == "Disposable":
+        return Disposable(parent, type, guid, initializer)
     if type == "ElementHandle":
         return ElementHandle(parent, type, guid, initializer)
     if type == "Frame":
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 4cecbd64c..020058acf 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -49,6 +49,7 @@
     from_nullable_channel,
 )
 from playwright._impl._console_message import ConsoleMessage
+from playwright._impl._disposable import Disposable, DisposableStub
 from playwright._impl._download import Download
 from playwright._impl._element_handle import ElementHandle, determine_screenshot_type
 from playwright._impl._errors import Error, TargetClosedError, is_target_closed_error
@@ -501,12 +502,12 @@ async def add_style_tag(
     ) -> ElementHandle:
         return await self._main_frame.add_style_tag(**locals_to_params(locals()))
 
-    async def expose_function(self, name: str, callback: Callable) -> None:
-        await self.expose_binding(name, lambda source, *args: callback(*args))
+    async def expose_function(self, name: str, callback: Callable) -> Disposable:
+        return await self.expose_binding(name, lambda source, *args: callback(*args))
 
     async def expose_binding(
         self, name: str, callback: Callable, handle: bool = None
-    ) -> None:
+    ) -> Disposable:
         if name in self._bindings:
             raise Error(f'Function "{name}" has been already registered')
         if name in self._browser_context._bindings:
@@ -514,10 +515,12 @@ async def expose_binding(
                 f'Function "{name}" has been already registered in the browser context'
             )
         self._bindings[name] = callback
-        await self._channel.send(
-            "exposeBinding",
-            None,
-            dict(name=name, needsHandle=handle or False),
+        return from_channel(
+            await self._channel.send(
+                "exposeBinding",
+                None,
+                dict(name=name, needsHandle=handle or False),
+            )
         )
 
     async def set_extra_http_headers(self, headers: Dict[str, str]) -> None:
@@ -661,18 +664,20 @@ async def bring_to_front(self) -> None:
 
     async def add_init_script(
         self, script: str = None, path: Union[str, Path] = None
-    ) -> None:
+    ) -> Disposable:
         if path:
             script = add_source_url_to_script(
                 (await async_readfile(path)).decode(), path
             )
         if not isinstance(script, str):
             raise Error("Either path or script parameter must be specified")
-        await self._channel.send("addInitScript", None, dict(source=script))
+        return from_channel(
+            await self._channel.send("addInitScript", None, dict(source=script))
+        )
 
     async def route(
         self, url: URLMatch, handler: RouteHandlerCallback, times: int = None
-    ) -> None:
+    ) -> DisposableStub:
         self._routes.insert(
             0,
             RouteHandler(
@@ -684,6 +689,7 @@ async def route(
             ),
         )
         await self._update_interception_patterns()
+        return DisposableStub(lambda: self.unroute(url, handler), self)
 
     async def unroute(
         self, url: URLMatch, handler: Optional[RouteHandlerCallback] = None
diff --git a/playwright/_impl/_screencast.py b/playwright/_impl/_screencast.py
index 1f19c7220..1f1da3c4f 100644
--- a/playwright/_impl/_screencast.py
+++ b/playwright/_impl/_screencast.py
@@ -19,6 +19,7 @@
 from playwright._impl._api_structures import ScreencastFrame
 from playwright._impl._artifact import Artifact
 from playwright._impl._connection import from_nullable_channel
+from playwright._impl._disposable import DisposableStub
 from playwright._impl._errors import Error
 from playwright._impl._helper import locals_to_params
 
@@ -63,7 +64,7 @@ async def start(
         onFrame: ScreencastFrameCallback = None,
         path: Union[str, Path] = None,
         quality: int = None,
-    ) -> None:
+    ) -> DisposableStub:
         if self._started:
             raise Error("Screencast is already started")
         self._started = True
@@ -81,6 +82,7 @@ async def start(
         if artifact_channel:
             self._artifact = from_nullable_channel(artifact_channel)
             self._save_path = path
+        return DisposableStub(lambda: self.stop(), self._page)
 
     async def stop(self) -> None:
         self._started = False
@@ -96,18 +98,26 @@ async def show_actions(
         duration: float = None,
         position: ScreencastPosition = None,
         fontSize: int = None,
-    ) -> None:
+    ) -> DisposableStub:
         await self._page._channel.send(
             "screencastShowActions", None, locals_to_params(locals())
         )
+        return DisposableStub(lambda: self.hide_actions(), self._page)
 
     async def hide_actions(self) -> None:
         await self._page._channel.send("screencastHideActions", None)
 
-    async def show_overlay(self, html: str, duration: float = None) -> None:
-        await self._page._channel.send(
+    async def show_overlay(self, html: str, duration: float = None) -> DisposableStub:
+        result = await self._page._channel.send_return_as_dict(
             "screencastShowOverlay", None, locals_to_params(locals())
         )
+        overlay_id = (result or {}).get("id")
+        return DisposableStub(
+            lambda: self._page._channel.send(
+                "screencastRemoveOverlay", None, {"id": overlay_id}
+            ),
+            self._page,
+        )
 
     async def show_chapter(
         self,
diff --git a/playwright/_impl/_tracing.py b/playwright/_impl/_tracing.py
index 8dda75994..2798b89d9 100644
--- a/playwright/_impl/_tracing.py
+++ b/playwright/_impl/_tracing.py
@@ -18,6 +18,7 @@
 from playwright._impl._api_structures import TracingGroupLocation
 from playwright._impl._artifact import Artifact
 from playwright._impl._connection import ChannelOwner, from_nullable_channel
+from playwright._impl._disposable import DisposableStub
 from playwright._impl._helper import locals_to_params
 
 
@@ -148,8 +149,11 @@ def _reset_stack_counter(self) -> None:
             self._is_tracing = False
             self._connection.set_is_tracing(False)
 
-    async def group(self, name: str, location: TracingGroupLocation = None) -> None:
+    async def group(
+        self, name: str, location: TracingGroupLocation = None
+    ) -> DisposableStub:
         await self._channel.send("tracingGroup", None, locals_to_params(locals()))
+        return DisposableStub(lambda: self.group_end(), self)
 
     async def group_end(self) -> None:
         await self._channel.send(
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 7119b9d84..5ca533ef2 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -62,6 +62,7 @@
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
 from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
+from playwright._impl._disposable import Disposable as DisposableImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
 from playwright._impl._errors import Error
@@ -7469,7 +7470,7 @@ async def start(
         ] = None,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Screencast.start
 
         Starts the screencast. When `path` is provided, it saves video recording to the specified file. When `onFrame` is
@@ -7485,9 +7486,13 @@ async def start(
             Path where the video should be saved when the screencast is stopped. When provided, video recording is started.
         quality : Union[int, None]
             The quality of the image, between 0-100.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.start(
                 onFrame=self._wrap_handler(on_frame), path=path, quality=quality
             )
@@ -7512,7 +7517,7 @@ async def show_actions(
             ]
         ] = None,
         font_size: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Screencast.show_actions
 
         Enables visual annotations on interacted elements. Returns a disposable that stops showing actions when disposed.
@@ -7525,9 +7530,13 @@ async def show_actions(
             Position of the action title overlay. Defaults to `"top-right"`.
         font_size : Union[int, None]
             Font size of the action title in pixels. Defaults to `24`.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.show_actions(
                 duration=duration, position=position, fontSize=font_size
             )
@@ -7543,7 +7552,7 @@ async def hide_actions(self) -> None:
 
     async def show_overlay(
         self, html: str, *, duration: typing.Optional[float] = None
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Screencast.show_overlay
 
         Adds an overlay with the given HTML content. The overlay is displayed on top of the page until removed. Returns a
@@ -7556,9 +7565,13 @@ async def show_overlay(
         duration : Union[float, None]
             Duration in milliseconds after which the overlay is automatically removed. Overlay stays until dismissed if not
             provided.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.show_overlay(html=html, duration=duration)
         )
 
@@ -9100,7 +9113,9 @@ async def add_style_tag(
             await self._impl_obj.add_style_tag(url=url, path=path, content=content)
         )
 
-    async def expose_function(self, name: str, callback: typing.Callable) -> None:
+    async def expose_function(
+        self, name: str, callback: typing.Callable
+    ) -> "AsyncContextManager":
         """Page.expose_function
 
         The method adds a function called `name` on the `window` object of every frame in the page. When called, the
@@ -9154,9 +9169,13 @@ async def main():
             Name of the function on the window object
         callback : Callable
             Callback function which will be called in Playwright's context.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.expose_function(
                 name=name, callback=self._wrap_handler(callback)
             )
@@ -9168,7 +9187,7 @@ async def expose_binding(
         callback: typing.Callable,
         *,
         handle: typing.Optional[bool] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Page.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in this page. When called, the
@@ -9223,9 +9242,13 @@ async def main():
             Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
             supported. When passing by value, multiple arguments are supported.
             Deprecated: This option will be removed in the future.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.expose_binding(
                 name=name, callback=self._wrap_handler(callback), handle=handle
             )
@@ -9760,7 +9783,7 @@ async def add_init_script(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Page.add_init_script
 
         Adds a script which would be evaluated in one of the following scenarios:
@@ -9790,9 +9813,13 @@ async def add_init_script(
         path : Union[pathlib.Path, str, None]
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory. Optional.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.add_init_script(script=script, path=path)
         )
 
@@ -9805,7 +9832,7 @@ async def route(
         ],
         *,
         times: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Page.route
 
         Routing provides the capability to modify network requests that are made by a page.
@@ -9873,9 +9900,13 @@ async def handle_route(route: Route):
             handler function to route the request.
         times : Union[int, None]
             How often a route should be used. By default it will be used every time.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.route(
                 url=self._wrap_handler(url),
                 handler=self._wrap_handler(handler),
@@ -13512,7 +13543,7 @@ async def add_init_script(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """BrowserContext.add_init_script
 
         Adds a script which would be evaluated in one of the following scenarios:
@@ -13542,9 +13573,13 @@ async def add_init_script(
         path : Union[pathlib.Path, str, None]
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory. Optional.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.add_init_script(script=script, path=path)
         )
 
@@ -13554,7 +13589,7 @@ async def expose_binding(
         callback: typing.Callable,
         *,
         handle: typing.Optional[bool] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """BrowserContext.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -13607,15 +13642,21 @@ async def main():
             Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
             supported. When passing by value, multiple arguments are supported.
             Deprecated: This option will be removed in the future.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.expose_binding(
                 name=name, callback=self._wrap_handler(callback), handle=handle
             )
         )
 
-    async def expose_function(self, name: str, callback: typing.Callable) -> None:
+    async def expose_function(
+        self, name: str, callback: typing.Callable
+    ) -> "AsyncContextManager":
         """BrowserContext.expose_function
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -13668,9 +13709,13 @@ async def main():
             Name of the function on the window object.
         callback : Callable
             Callback function that will be called in the Playwright's context.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.expose_function(
                 name=name, callback=self._wrap_handler(callback)
             )
@@ -13685,7 +13730,7 @@ async def route(
         ],
         *,
         times: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "AsyncContextManager":
         """BrowserContext.route
 
         Routing provides the capability to modify network requests that are made by any page in the browser context. Once
@@ -13747,9 +13792,13 @@ async def handle_route(route: Route):
             handler function to route the request.
         times : Union[int, None]
             How often a route should be used. By default it will be used every time.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.route(
                 url=self._wrap_handler(url),
                 handler=self._wrap_handler(handler),
@@ -15882,7 +15931,7 @@ async def stop(
 
     async def group(
         self, name: str, *, location: typing.Optional[TracingGroupLocation] = None
-    ) -> None:
+    ) -> "AsyncContextManager":
         """Tracing.group
 
         **NOTE** Use `test.step` instead when available.
@@ -15908,9 +15957,13 @@ async def group(
         location : Union[{file: str, line: Union[int, None], column: Union[int, None]}, None]
             Specifies a custom location for the group to be shown in the trace viewer. Defaults to the location of the
             `tracing.group()` call.
+
+        Returns
+        -------
+        AsyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             await self._impl_obj.group(name=name, location=location)
         )
 
@@ -21643,3 +21696,22 @@ async def not_to_be_ok(self) -> None:
 
 
 mapping.register(APIResponseAssertionsImpl, APIResponseAssertions)
+
+
+class Disposable(AsyncContextManager):
+
+    async def dispose(self) -> None:
+        """Disposable.dispose
+
+        Removes the associated resource. For example, removes the init script installed via `page.add_init_script()`
+        or `browser_context.add_init_script()`.
+        """
+
+        return mapping.from_maybe_impl(await self._impl_obj.dispose())
+
+    async def close(self) -> None:
+
+        return mapping.from_maybe_impl(await self._impl_obj.close())
+
+
+mapping.register(DisposableImpl, Disposable)
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index d7809f507..f7a8a2c24 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -56,6 +56,7 @@
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
 from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
+from playwright._impl._disposable import Disposable as DisposableImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
 from playwright._impl._errors import Error
@@ -7541,7 +7542,7 @@ def start(
         ] = None,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
         quality: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """Screencast.start
 
         Starts the screencast. When `path` is provided, it saves video recording to the specified file. When `onFrame` is
@@ -7557,9 +7558,13 @@ def start(
             Path where the video should be saved when the screencast is stopped. When provided, video recording is started.
         quality : Union[int, None]
             The quality of the image, between 0-100.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.start(
                     onFrame=self._wrap_handler(on_frame), path=path, quality=quality
@@ -7586,7 +7591,7 @@ def show_actions(
             ]
         ] = None,
         font_size: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """Screencast.show_actions
 
         Enables visual annotations on interacted elements. Returns a disposable that stops showing actions when disposed.
@@ -7599,9 +7604,13 @@ def show_actions(
             Position of the action title overlay. Defaults to `"top-right"`.
         font_size : Union[int, None]
             Font size of the action title in pixels. Defaults to `24`.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.show_actions(
                     duration=duration, position=position, fontSize=font_size
@@ -7619,7 +7628,7 @@ def hide_actions(self) -> None:
 
     def show_overlay(
         self, html: str, *, duration: typing.Optional[float] = None
-    ) -> None:
+    ) -> "SyncContextManager":
         """Screencast.show_overlay
 
         Adds an overlay with the given HTML content. The overlay is displayed on top of the page until removed. Returns a
@@ -7632,9 +7641,13 @@ def show_overlay(
         duration : Union[float, None]
             Duration in milliseconds after which the overlay is automatically removed. Overlay stays until dismissed if not
             provided.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(self._impl_obj.show_overlay(html=html, duration=duration))
         )
 
@@ -9097,7 +9110,9 @@ def add_style_tag(
             )
         )
 
-    def expose_function(self, name: str, callback: typing.Callable) -> None:
+    def expose_function(
+        self, name: str, callback: typing.Callable
+    ) -> "SyncContextManager":
         """Page.expose_function
 
         The method adds a function called `name` on the `window` object of every frame in the page. When called, the
@@ -9148,9 +9163,13 @@ def run(playwright: Playwright):
             Name of the function on the window object
         callback : Callable
             Callback function which will be called in Playwright's context.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.expose_function(
                     name=name, callback=self._wrap_handler(callback)
@@ -9164,7 +9183,7 @@ def expose_binding(
         callback: typing.Callable,
         *,
         handle: typing.Optional[bool] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """Page.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in this page. When called, the
@@ -9216,9 +9235,13 @@ def run(playwright: Playwright):
             Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
             supported. When passing by value, multiple arguments are supported.
             Deprecated: This option will be removed in the future.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.expose_binding(
                     name=name, callback=self._wrap_handler(callback), handle=handle
@@ -9767,7 +9790,7 @@ def add_init_script(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """Page.add_init_script
 
         Adds a script which would be evaluated in one of the following scenarios:
@@ -9797,9 +9820,13 @@ def add_init_script(
         path : Union[pathlib.Path, str, None]
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory. Optional.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(self._impl_obj.add_init_script(script=script, path=path))
         )
 
@@ -9812,7 +9839,7 @@ def route(
         ],
         *,
         times: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """Page.route
 
         Routing provides the capability to modify network requests that are made by a page.
@@ -9880,9 +9907,13 @@ def handle_route(route: Route):
             handler function to route the request.
         times : Union[int, None]
             How often a route should be used. By default it will be used every time.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.route(
                     url=self._wrap_handler(url),
@@ -13512,7 +13543,7 @@ def add_init_script(
         script: typing.Optional[str] = None,
         *,
         path: typing.Optional[typing.Union[pathlib.Path, str]] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """BrowserContext.add_init_script
 
         Adds a script which would be evaluated in one of the following scenarios:
@@ -13542,9 +13573,13 @@ def add_init_script(
         path : Union[pathlib.Path, str, None]
             Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working
             directory. Optional.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(self._impl_obj.add_init_script(script=script, path=path))
         )
 
@@ -13554,7 +13589,7 @@ def expose_binding(
         callback: typing.Callable,
         *,
         handle: typing.Optional[bool] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """BrowserContext.expose_binding
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -13604,9 +13639,13 @@ def run(playwright: Playwright):
             Whether to pass the argument as a handle, instead of passing by value. When passing a handle, only one argument is
             supported. When passing by value, multiple arguments are supported.
             Deprecated: This option will be removed in the future.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.expose_binding(
                     name=name, callback=self._wrap_handler(callback), handle=handle
@@ -13614,7 +13653,9 @@ def run(playwright: Playwright):
             )
         )
 
-    def expose_function(self, name: str, callback: typing.Callable) -> None:
+    def expose_function(
+        self, name: str, callback: typing.Callable
+    ) -> "SyncContextManager":
         """BrowserContext.expose_function
 
         The method adds a function called `name` on the `window` object of every frame in every page in the context. When
@@ -13664,9 +13705,13 @@ def run(playwright: Playwright):
             Name of the function on the window object.
         callback : Callable
             Callback function that will be called in the Playwright's context.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.expose_function(
                     name=name, callback=self._wrap_handler(callback)
@@ -13683,7 +13728,7 @@ def route(
         ],
         *,
         times: typing.Optional[int] = None,
-    ) -> None:
+    ) -> "SyncContextManager":
         """BrowserContext.route
 
         Routing provides the capability to modify network requests that are made by any page in the browser context. Once
@@ -13746,9 +13791,13 @@ def handle_route(route: Route):
             handler function to route the request.
         times : Union[int, None]
             How often a route should be used. By default it will be used every time.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(
                 self._impl_obj.route(
                     url=self._wrap_handler(url),
@@ -15864,7 +15913,7 @@ def stop(
 
     def group(
         self, name: str, *, location: typing.Optional[TracingGroupLocation] = None
-    ) -> None:
+    ) -> "SyncContextManager":
         """Tracing.group
 
         **NOTE** Use `test.step` instead when available.
@@ -15890,9 +15939,13 @@ def group(
         location : Union[{file: str, line: Union[int, None], column: Union[int, None]}, None]
             Specifies a custom location for the group to be shown in the trace viewer. Defaults to the location of the
             `tracing.group()` call.
+
+        Returns
+        -------
+        SyncContextManager
         """
 
-        return mapping.from_maybe_impl(
+        return mapping.from_impl(
             self._sync(self._impl_obj.group(name=name, location=location))
         )
 
@@ -21771,3 +21824,22 @@ def not_to_be_ok(self) -> None:
 
 
 mapping.register(APIResponseAssertionsImpl, APIResponseAssertions)
+
+
+class Disposable(SyncContextManager):
+
+    def dispose(self) -> None:
+        """Disposable.dispose
+
+        Removes the associated resource. For example, removes the init script installed via `page.add_init_script()`
+        or `browser_context.add_init_script()`.
+        """
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.dispose()))
+
+    def close(self) -> None:
+
+        return mapping.from_maybe_impl(self._sync(self._impl_obj.close()))
+
+
+mapping.register(DisposableImpl, Disposable)
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 2e2264b06..8016a601d 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -39,12 +39,18 @@ def __init__(self, is_async: bool) -> None:
         )
         self.api = json.loads(process_output.stdout)
         self.errors: Set[str] = set()
+        self.class_aliases: Dict[str, str] = {
+            "Disposable": "AsyncContextManager" if is_async else "SyncContextManager",
+            "DisposableStub": (
+                "AsyncContextManager" if is_async else "SyncContextManager"
+            ),
+        }
         self._patch_case()
 
     def _patch_case(self) -> None:
         self.classes = {}
         for clazz in self.api:
-            if not works_for_python(clazz):
+            if not works_for_python(clazz) and clazz["name"] not in self.class_aliases:
                 continue
             members = {}
             self.classes[clazz["name"]] = clazz
@@ -343,6 +349,11 @@ def compare_types(
             doc_type = self.make_optional(doc_type)
 
         if doc_type != code_type:
+            if (
+                code_type in self.class_aliases
+                and doc_type == self.class_aliases[code_type]
+            ):
+                return
             self.errors.add(
                 f"Parameter type mismatch in {fqname}: documented as {doc_type}, code has {code_type}"
             )
@@ -372,7 +383,10 @@ def serialize_python_type(self, value: Any, direction: str) -> str:
         if match and "_api_structures" not in str_value and "_errors" not in str_value:
             if match.group(1) == "EventContextManagerImpl":
                 return "EventContextManager"
-            return match.group(1)
+            class_name = match.group(1)
+            if class_name in self.class_aliases:
+                return self.class_aliases[class_name]
+            return class_name
 
         match = re.match(r"^typing\.(\w+)$", str_value)
         if match:
@@ -512,6 +526,8 @@ def inner_serialize_doc_type(self, type: Any, direction: str) -> str:
             return "None"
         if type_name == "EvaluationArgument":
             return "Dict"
+        if type_name in self.class_aliases:
+            return self.class_aliases[type_name]
         return type["name"]
 
     def print_remainder(self) -> None:
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index f47493440..cddb87f15 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -4,6 +4,9 @@
 Parameter not documented: Browser.new_context(default_browser_type=)
 Parameter not documented: Browser.new_page(default_browser_type=)
 
+# python-specific adapter for context manager support
+Method not documented: Disposable.close
+
 # One vs two arguments in the callback, Python explicitly unions.
 Parameter type mismatch in BrowserContext.route(handler=): documented as Callable[[Route, Request], Union[Any, Any]], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any]]
 Parameter type mismatch in BrowserContext.unroute(handler=): documented as Union[Callable[[Route, Request], Union[Any, Any]], None], code has Union[Callable[[Route, Request], Any], Callable[[Route], Any], None]
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index eea3be7bd..9d217b7c5 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -31,6 +31,7 @@
 from playwright._impl._console_message import ConsoleMessage
 from playwright._impl._debugger import Debugger
 from playwright._impl._dialog import Dialog
+from playwright._impl._disposable import Disposable
 from playwright._impl._download import Download
 from playwright._impl._element_handle import ElementHandle
 from playwright._impl._fetch import APIRequest, APIRequestContext, APIResponse
@@ -235,6 +236,7 @@ def return_value(value: Any) -> List[str]:
 from playwright._impl._console_message import ConsoleMessage as ConsoleMessageImpl
 from playwright._impl._debugger import Debugger as DebuggerImpl
 from playwright._impl._dialog import Dialog as DialogImpl
+from playwright._impl._disposable import Disposable as DisposableImpl
 from playwright._impl._download import Download as DownloadImpl
 from playwright._impl._element_handle import ElementHandle as ElementHandleImpl
 from playwright._impl._file_chooser import FileChooser as FileChooserImpl
@@ -294,6 +296,7 @@ def return_value(value: Any) -> List[str]:
     PageAssertions,
     LocatorAssertions,
     APIResponseAssertions,
+    Disposable,
 ]
 
 all_types = generated_types + [
diff --git a/scripts/generate_async_api.py b/scripts/generate_async_api.py
index ca52ef1a3..4c0b4b655 100755
--- a/scripts/generate_async_api.py
+++ b/scripts/generate_async_api.py
@@ -39,7 +39,7 @@ def generate(t: Any) -> None:
     print("")
     class_name = short_name(t)
     base_class = t.__bases__[0].__name__
-    if class_name in ["Page", "BrowserContext", "Browser"]:
+    if class_name in ["Page", "BrowserContext", "Browser", "Disposable"]:
         base_sync_class = "AsyncContextManager"
     elif base_class in ["ChannelOwner", "object", "AssertionsBase"]:
         base_sync_class = "AsyncBase"
@@ -88,6 +88,9 @@ def generate(t: Any) -> None:
             return_type_value = return_type_value.replace(
                 "EventContextManager", "AsyncEventContextManager"
             )
+            return_type_value = return_type_value.replace(
+                '"Disposable"', '"AsyncContextManager"'
+            ).replace('"DisposableStub"', '"AsyncContextManager"')
             print("")
             async_prefix = "async " if is_async else ""
             print(
diff --git a/scripts/generate_sync_api.py b/scripts/generate_sync_api.py
index 01d6cb02b..5ccf3b672 100755
--- a/scripts/generate_sync_api.py
+++ b/scripts/generate_sync_api.py
@@ -40,7 +40,7 @@ def generate(t: Any) -> None:
     print("")
     class_name = short_name(t)
     base_class = t.__bases__[0].__name__
-    if class_name in ["Page", "BrowserContext", "Browser"]:
+    if class_name in ["Page", "BrowserContext", "Browser", "Disposable"]:
         base_sync_class = "SyncContextManager"
     elif base_class in ["ChannelOwner", "object", "AssertionsBase"]:
         base_sync_class = "SyncBase"
@@ -86,6 +86,9 @@ def generate(t: Any) -> None:
             is_async = inspect.iscoroutinefunction(value)
             return_type_value = return_type(value)
             return_type_value = re.sub(r"\"([^\"]+)Impl\"", r"\1", return_type_value)
+            return_type_value = return_type_value.replace(
+                '"Disposable"', '"SyncContextManager"'
+            ).replace('"DisposableStub"', '"SyncContextManager"')
             print("")
             print(
                 f"    def {name}({signature(value, len(name) + 9)}) -> {return_type_value}:"
diff --git a/tests/async/test_add_init_script.py b/tests/async/test_add_init_script.py
index 33853780a..7dbae8aba 100644
--- a/tests/async/test_add_init_script.py
+++ b/tests/async/test_add_init_script.py
@@ -89,3 +89,13 @@ async def test_should_work_with_trailing_comments(page: Page) -> None:
     await page.add_init_script("window.secret = 42;")
     await page.goto("data:text/html,<html></html>")
     assert await page.evaluate("secret") == 42
+
+
+async def test_add_init_script_returns_disposable(page: Page) -> None:
+    async with await page.add_init_script("window.injected = 123"):
+        await page.goto(
+            "data:text/html,<script>window.result = window.injected</script>"
+        )
+        assert await page.evaluate("window.result") == 123
+    await page.goto("data:text/html,<script>window.result = window.injected</script>")
+    assert await page.evaluate("window.result") is None
diff --git a/tests/async/test_page_route.py b/tests/async/test_page_route.py
index 848a95045..ecfac7f73 100644
--- a/tests/async/test_page_route.py
+++ b/tests/async/test_page_route.py
@@ -1246,3 +1246,18 @@ async def handle_question_mark(route: Route) -> None:
 
     await page.goto(server.PREFIX + "/index123hello")
     await expect(page.locator("body")).to_have_text("index123hello")
+
+
+async def test_page_route_returns_disposable(page: Page, server: Server) -> None:
+    intercepted: List[str] = []
+
+    async def handler(route: Route) -> None:
+        intercepted.append(route.request.url)
+        await route.continue_()
+
+    async with await page.route("**/*", handler):
+        await page.goto(server.EMPTY_PAGE)
+        assert any(server.EMPTY_PAGE in url for url in intercepted)
+    intercepted.clear()
+    await page.goto(server.EMPTY_PAGE)
+    assert intercepted == []
diff --git a/tests/sync/test_add_init_script.py b/tests/sync/test_add_init_script.py
index e17fc5e8b..cd508cf4d 100644
--- a/tests/sync/test_add_init_script.py
+++ b/tests/sync/test_add_init_script.py
@@ -85,3 +85,11 @@ def test_should_work_with_trailing_comments(page: Page) -> None:
     page.add_init_script("window.secret = 42;")
     page.goto("data:text/html,<html></html>")
     assert page.evaluate("secret") == 42
+
+
+def test_add_init_script_returns_disposable(page: Page) -> None:
+    with page.add_init_script("window.injected = 123"):
+        page.goto("data:text/html,<script>window.result = window.injected</script>")
+        assert page.evaluate("window.result") == 123
+    page.goto("data:text/html,<script>window.result = window.injected</script>")
+    assert page.evaluate("window.result") is None
diff --git a/tests/sync/test_unroute_behavior.py b/tests/sync/test_unroute_behavior.py
index 12ae9e22d..f37146582 100644
--- a/tests/sync/test_unroute_behavior.py
+++ b/tests/sync/test_unroute_behavior.py
@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from playwright.sync_api import BrowserContext, Page
+from playwright.sync_api import BrowserContext, Page, Route
 from tests.server import Server
 from tests.utils import must
 
@@ -44,3 +44,18 @@ def test_page_unroute_all_removes_all_routes(page: Page, server: Server) -> None
     page.unroute_all()
     response = must(page.goto(server.EMPTY_PAGE))
     assert response.ok
+
+
+def test_page_route_returns_disposable(page: Page, server: Server) -> None:
+    intercepted: list = []
+
+    def handler(route: Route) -> None:
+        intercepted.append(route.request.url)
+        route.continue_()
+
+    with page.route("**/*", handler):
+        page.goto(server.EMPTY_PAGE)
+        assert any(server.EMPTY_PAGE in url for url in intercepted)
+    intercepted.clear()
+    page.goto(server.EMPTY_PAGE)
+    assert intercepted == []

From 1f847dd8cfc9dc533151d3dea28380fb39722bad Mon Sep 17 00:00:00 2001
From: Pavel Feldman <pavel.feldman@gmail.com>
Date: Wed, 29 Apr 2026 11:06:10 -0700
Subject: [PATCH 09/13] fix(ci): pass launch args to bind test, pin macOS
 WebKit to xlarge (#3051)

---
 .github/workflows/ci.yml                         | 13 ++++++++++++-
 tests/async/test_browser.py                      |  5 +++--
 tests/async/test_browsercontext_storage_state.py |  7 ++++++-
 tests/async/test_browsertype_connect_cdp.py      |  4 +++-
 tests/sync/test_browser.py                       | 16 ++++++++++++++++
 5 files changed, 40 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ecb593832..eb06caff0 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -50,7 +50,18 @@ jobs:
         os: [ubuntu-latest, windows-latest, macos-latest]
         python-version: ['3.9', '3.10']
         browser: [chromium, firefox, webkit]
+        exclude:
+        # WebKit on standard macOS-latest (currently macos-15-arm64) is unstable;
+        # upstream pins paid macos-15-xlarge for cross-browser webkit too.
+        - os: macos-latest
+          browser: webkit
         include:
+        - os: macos-15-xlarge
+          python-version: '3.9'
+          browser: webkit
+        - os: macos-15-xlarge
+          python-version: '3.10'
+          browser: webkit
         - os: windows-latest
           python-version: '3.11'
           browser: chromium
@@ -160,7 +171,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-22.04, macos-13, windows-2022]
+        os: [ubuntu-22.04, macos-latest, windows-2022]
     runs-on: ${{ matrix.os }}
     defaults:
       run:
diff --git a/tests/async/test_browser.py b/tests/async/test_browser.py
index 84e9a4844..fc3f836a8 100644
--- a/tests/async/test_browser.py
+++ b/tests/async/test_browser.py
@@ -13,6 +13,7 @@
 # limitations under the License.
 
 import re
+from typing import Dict
 
 import pytest
 
@@ -56,9 +57,9 @@ async def test_should_return_browser_type(
 
 
 async def test_bind_should_return_endpoint_and_allow_unbind(
-    browser_type: BrowserType,
+    browser_type: BrowserType, launch_arguments: Dict
 ) -> None:
-    browser = await browser_type.launch()
+    browser = await browser_type.launch(**launch_arguments)
     try:
         result = await browser.bind("test-server")
         assert "endpoint" in result
diff --git a/tests/async/test_browsercontext_storage_state.py b/tests/async/test_browsercontext_storage_state.py
index 17df45a0e..02fb0e2b0 100644
--- a/tests/async/test_browsercontext_storage_state.py
+++ b/tests/async/test_browsercontext_storage_state.py
@@ -15,6 +15,9 @@
 import asyncio
 import json
 from pathlib import Path
+from typing import Optional
+
+import pytest
 
 from playwright.async_api import Browser, BrowserContext, Page, StorageState
 from tests.server import Server
@@ -134,8 +137,10 @@ async def test_should_round_trip_through_the_file(
 
 
 async def test_set_storage_state_should_apply_state_to_existing_context(
-    browser: Browser,
+    browser: Browser, browser_channel: Optional[str]
 ) -> None:
+    if browser_channel and browser_channel.startswith("msedge"):
+        pytest.skip("Network.clearBrowserCache sometimes stalls on msedge")
     src = await browser.new_context()
     src_page = await src.new_page()
     await src_page.route(
diff --git a/tests/async/test_browsertype_connect_cdp.py b/tests/async/test_browsertype_connect_cdp.py
index 251781546..dc66d3a07 100644
--- a/tests/async/test_browsertype_connect_cdp.py
+++ b/tests/async/test_browsertype_connect_cdp.py
@@ -96,7 +96,9 @@ async def test_connect_over_cdp_passing_header_works(
     request = asyncio.create_task(server.wait_for_request("/ws"))
     with pytest.raises(Error):
         await browser_type.connect_over_cdp(
-            f"ws://127.0.0.1:{server.PORT}/ws", headers={"foo": "bar"}
+            f"ws://127.0.0.1:{server.PORT}/ws",
+            headers={"foo": "bar"},
+            timeout=5000,
         )
     assert (await request).getHeader("foo") == "bar"
 
diff --git a/tests/sync/test_browser.py b/tests/sync/test_browser.py
index ded881c67..2551571da 100644
--- a/tests/sync/test_browser.py
+++ b/tests/sync/test_browser.py
@@ -12,6 +12,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+from typing import Dict
+
 from playwright.sync_api import Browser, BrowserType
 
 
@@ -19,3 +21,17 @@ def test_should_return_browser_type(
     browser: Browser, browser_type: BrowserType
 ) -> None:
     assert browser.browser_type is browser_type
+
+
+def test_bind_should_return_endpoint_and_allow_unbind(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    browser = browser_type.launch(**launch_arguments)
+    try:
+        result = browser.bind("test-server")
+        assert "endpoint" in result
+        assert isinstance(result["endpoint"], str)
+        assert len(result["endpoint"]) > 0
+        browser.unbind()
+    finally:
+        browser.close()

From 797946e5fc74825d6bec80ec2e59689aed7b7c8e Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Thu, 30 Apr 2026 15:26:52 +0200
Subject: [PATCH 10/13] fix: support async predicates in
 page.expect_request/expect_response (#3055)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 CLAUDE.md                          |  4 +++
 playwright/_impl/_helper.py        |  9 ++++--
 playwright/_impl/_page.py          |  5 +--
 playwright/_impl/_waiter.py        | 44 ++++++++++++++++++++++++---
 playwright/async_api/_generated.py | 12 +++++---
 scripts/documentation_provider.py  | 10 ++++++
 scripts/expected_api_mismatch.txt  |  4 +++
 scripts/generate_api.py            | 11 +++++++
 scripts/generate_sync_api.py       |  3 ++
 tests/async/test_page.py           | 49 +++++++++++++++++++++++++++++-
 10 files changed, 137 insertions(+), 14 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index ce4ec7c07..4153ac4d1 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -48,6 +48,10 @@ This is the recurring high-stakes task. Use the dedicated skill:
 
 It documents the full process: the upstream commit-range diff over `docs/src/api/`, how to classify each commit (PORT / MISMATCH / N/A), how to handle the `langs:` filter, the recurring failure modes, and the tests/sync-mirroring conventions.
 
+## Working on PRs
+
+- Never post comments, replies, or reviews on GitHub PRs/issues under my account without my explicit approval. Draft the proposed text and wait for me to approve before sending.
+
 ## House style
 
 - Don't hand-edit generated files.
diff --git a/playwright/_impl/_helper.py b/playwright/_impl/_helper.py
index 1d7e4f67b..dc0a2479d 100644
--- a/playwright/_impl/_helper.py
+++ b/playwright/_impl/_helper.py
@@ -22,6 +22,7 @@
 from typing import (
     TYPE_CHECKING,
     Any,
+    Awaitable,
     Callable,
     Dict,
     List,
@@ -54,8 +55,12 @@
     from playwright._impl._network import Request, Response, Route, WebSocketRoute
 
 URLMatch = Union[str, Pattern[str], Callable[[str], bool]]
-URLMatchRequest = Union[str, Pattern[str], Callable[["Request"], bool]]
-URLMatchResponse = Union[str, Pattern[str], Callable[["Response"], bool]]
+URLMatchRequest = Union[
+    str, Pattern[str], Callable[["Request"], Union[bool, Awaitable[bool]]]
+]
+URLMatchResponse = Union[
+    str, Pattern[str], Callable[["Response"], Union[bool, Awaitable[bool]]]
+]
 RouteHandlerCallback = Union[
     Callable[["Route"], Any], Callable[["Route", "Request"], Any]
 ]
diff --git a/playwright/_impl/_page.py b/playwright/_impl/_page.py
index 020058acf..5a8444624 100644
--- a/playwright/_impl/_page.py
+++ b/playwright/_impl/_page.py
@@ -22,6 +22,7 @@
 from typing import (
     TYPE_CHECKING,
     Any,
+    Awaitable,
     Callable,
     Dict,
     List,
@@ -1278,7 +1279,7 @@ def expect_request(
         urlOrPredicate: URLMatchRequest,
         timeout: float = None,
     ) -> EventContextManagerImpl[Request]:
-        def my_predicate(request: Request) -> bool:
+        def my_predicate(request: Request) -> Union[bool, Awaitable[bool]]:
             if not callable(urlOrPredicate):
                 return url_matches(
                     self._browser_context._base_url,
@@ -1310,7 +1311,7 @@ def expect_response(
         urlOrPredicate: URLMatchResponse,
         timeout: float = None,
     ) -> EventContextManagerImpl[Response]:
-        def my_predicate(request: Response) -> bool:
+        def my_predicate(request: Response) -> Union[bool, Awaitable[bool]]:
             if not callable(urlOrPredicate):
                 return url_matches(
                     self._browser_context._base_url,
diff --git a/playwright/_impl/_waiter.py b/playwright/_impl/_waiter.py
index f7ff4b6c1..b5bf53382 100644
--- a/playwright/_impl/_waiter.py
+++ b/playwright/_impl/_waiter.py
@@ -13,10 +13,11 @@
 # limitations under the License.
 
 import asyncio
+import inspect
 import math
 import uuid
 from asyncio.tasks import Task
-from typing import Any, Callable, List, Tuple, Union
+from typing import Any, Callable, List, Optional, Tuple, Union
 
 from pyee import EventEmitter
 
@@ -71,9 +72,11 @@ def reject_on_event(
         error: Union[Error, Callable[..., Error]],
         predicate: Callable = None,
     ) -> None:
+        def on_match() -> None:
+            self._reject(error() if callable(error) else error)
+
         def listener(event_data: Any = None) -> None:
-            if not predicate or predicate(event_data):
-                self._reject(error() if callable(error) else error)
+            self._evaluate_predicate(predicate, event_data, on_match)
 
         emitter.on(event, listener)
         self._registered_listeners.append((emitter, event, listener))
@@ -117,12 +120,43 @@ def wait_for_event(
         predicate: Callable = None,
     ) -> None:
         def listener(event_data: Any = None) -> None:
-            if not predicate or predicate(event_data):
-                self._fulfill(event_data)
+            self._evaluate_predicate(
+                predicate, event_data, lambda: self._fulfill(event_data)
+            )
 
         emitter.on(event, listener)
         self._registered_listeners.append((emitter, event, listener))
 
+    def _evaluate_predicate(
+        self,
+        predicate: Optional[Callable],
+        event_data: Any,
+        on_match: Callable[[], None],
+    ) -> None:
+        if predicate is None:
+            on_match()
+            return
+        try:
+            result = predicate(event_data)
+        except Exception as e:
+            self._reject(e)
+            return
+        if inspect.iscoroutine(result):
+
+            async def _await_predicate(coro: Any) -> None:
+                try:
+                    matched = await coro
+                except Exception as e:
+                    self._reject(e)
+                    return
+                if matched and not self._result.done():
+                    on_match()
+
+            self._pending_tasks.append(self._loop.create_task(_await_predicate(result)))
+            return
+        if result:
+            on_match()
+
     def result(self) -> asyncio.Future:
         return self._result
 
diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 5ca533ef2..130230390 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -12306,7 +12306,9 @@ def expect_popup(
     def expect_request(
         self,
         url_or_predicate: typing.Union[
-            str, typing.Pattern[str], typing.Callable[["Request"], bool]
+            str,
+            typing.Pattern[str],
+            typing.Callable[["Request"], typing.Union[bool, typing.Awaitable[bool]]],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -12331,7 +12333,7 @@ def expect_request(
 
         Parameters
         ----------
-        url_or_predicate : Union[Callable[[Request], bool], Pattern[str], str]
+        url_or_predicate : Union[Callable[[Request], Union[bool, typing.Awaitable[bool]]], Pattern[str], str]
             Request URL string, regex or predicate receiving `Request` object. When a `baseURL` via the context options was
             provided and the passed URL is a path, it gets merged via the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
@@ -12384,7 +12386,9 @@ def expect_request_finished(
     def expect_response(
         self,
         url_or_predicate: typing.Union[
-            str, typing.Pattern[str], typing.Callable[["Response"], bool]
+            str,
+            typing.Pattern[str],
+            typing.Callable[["Response"], typing.Union[bool, typing.Awaitable[bool]]],
         ],
         *,
         timeout: typing.Optional[float] = None,
@@ -12411,7 +12415,7 @@ def expect_response(
 
         Parameters
         ----------
-        url_or_predicate : Union[Callable[[Response], bool], Pattern[str], str]
+        url_or_predicate : Union[Callable[[Response], Union[bool, typing.Awaitable[bool]]], Pattern[str], str]
             Request URL string, regex or predicate receiving `Response` object. When a `baseURL` via the context options was
             provided and the passed URL is a path, it gets merged via the
             [`new URL()`](https://developer.mozilla.org/en-US/docs/Web/API/URL/URL) constructor.
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 8016a601d..4c2d9b95d 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -408,6 +408,16 @@ def serialize_python_type(self, value: Any, direction: str) -> str:
             return f"{{{', '.join(signature)}}}"
         if origin == Union:
             args = get_args(value)
+            if not self.is_async:
+                # Sync API doesn't accept awaitable callbacks; drop the
+                # Awaitable arm so docstring types match the sync signature.
+                args = tuple(
+                    a
+                    for a in args
+                    if str(get_origin(a)) != "<class 'collections.abc.Awaitable'>"
+                )
+                if len(args) == 1:
+                    return self.serialize_python_type(args[0], direction)
             if len(args) == 2 and str(args[1]) == "<class 'NoneType'>":
                 return self.make_optional(
                     self.serialize_python_type(args[0], direction)
diff --git a/scripts/expected_api_mismatch.txt b/scripts/expected_api_mismatch.txt
index cddb87f15..d9bcc41a0 100644
--- a/scripts/expected_api_mismatch.txt
+++ b/scripts/expected_api_mismatch.txt
@@ -20,3 +20,7 @@ Parameter type mismatch in BrowserContext.route_web_socket(handler=): documented
 Parameter type mismatch in Page.route_web_socket(handler=): documented as Callable[[WebSocketRoute], Union[Any, Any]], code has Callable[[WebSocketRoute], Any]
 Parameter type mismatch in WebSocketRoute.on_close(handler=): documented as Callable[[Union[int, undefined]], Union[Any, Any]], code has Callable[[Union[int, None], Union[str, None]], Any]
 Parameter type mismatch in WebSocketRoute.on_message(handler=): documented as Callable[[str], Union[Any, Any]], code has Callable[[Union[bytes, str]], Any]
+
+# Async API additionally accepts an `async def` predicate.
+Parameter type mismatch in Page.expect_request(url_or_predicate=): documented as Union[Callable[[Request], bool], Pattern[str], str], code has Union[Callable[[Request], Union[bool, typing.Awaitable[bool]]], Pattern[str], str]
+Parameter type mismatch in Page.expect_response(url_or_predicate=): documented as Union[Callable[[Response], bool], Pattern[str], str], code has Union[Callable[[Response], Union[bool, typing.Awaitable[bool]]], Pattern[str], str]
diff --git a/scripts/generate_api.py b/scripts/generate_api.py
index 9d217b7c5..07a1f2182 100644
--- a/scripts/generate_api.py
+++ b/scripts/generate_api.py
@@ -56,6 +56,8 @@
 from playwright._impl._video import Video
 from playwright._impl._web_error import WebError
 
+SYNC_API = False
+
 
 def process_type(value: Any, param: bool = False) -> str:
     value = str(value)
@@ -65,6 +67,15 @@ def process_type(value: Any, param: bool = False) -> str:
     value = re.sub(r"playwright\._impl\._api_structures.([\w]+)", r"\1", value)
     value = re.sub(r"playwright\._impl\.[\w]+\.([\w]+)", r'"\1"', value)
     value = re.sub(r"typing.Literal", "Literal", value)
+    if SYNC_API:
+        # Sync API does not accept awaitable callbacks; collapse
+        # Union[X, Awaitable[X]] (used for predicates the async API also
+        # accepts as `async def`) down to just X.
+        value = re.sub(
+            r"typing\.Union\[([^\[\],]+),\s*typing\.Awaitable\[\1\]\]",
+            r"\1",
+            value,
+        )
     if param:
         value = re.sub(r"^typing.Union\[([^,]+), None\]$", r"\1 = None", value)
         value = re.sub(
diff --git a/scripts/generate_sync_api.py b/scripts/generate_sync_api.py
index 5ccf3b672..dbabce413 100755
--- a/scripts/generate_sync_api.py
+++ b/scripts/generate_sync_api.py
@@ -19,6 +19,7 @@
 from types import FunctionType
 from typing import Any
 
+import generate_api
 from documentation_provider import DocumentationProvider
 from generate_api import (
     api_globals,
@@ -33,6 +34,8 @@
     signature,
 )
 
+generate_api.SYNC_API = True
+
 documentation_provider = DocumentationProvider(False)
 
 
diff --git a/tests/async/test_page.py b/tests/async/test_page.py
index 562d98248..2fcf4c92d 100644
--- a/tests/async/test_page.py
+++ b/tests/async/test_page.py
@@ -16,7 +16,7 @@
 import os
 import re
 from pathlib import Path
-from typing import Dict, List, Optional
+from typing import Any, Dict, List, Optional
 
 import pytest
 
@@ -352,6 +352,53 @@ async def test_wait_for_response_should_work_with_predicate(
     assert response.url == server.PREFIX + "/digits/2.png"
 
 
+async def test_wait_for_response_should_work_with_async_predicate(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    async def predicate(response: Any) -> bool:
+        await asyncio.sleep(0)
+        return response.url == server.PREFIX + "/digits/2.png"
+
+    async with page.expect_response(predicate) as response_info:
+        await page.evaluate(
+            """() => {
+                fetch('/digits/1.png')
+                fetch('/digits/2.png')
+                fetch('/digits/3.png')
+            }"""
+        )
+    response = await response_info.value
+    assert response.url == server.PREFIX + "/digits/2.png"
+
+
+async def test_expect_response_should_reject_when_async_predicate_throws(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    async def predicate(response: Any) -> bool:
+        raise Exception("Async oops!")
+
+    with pytest.raises(Exception, match="Async oops!"):
+        async with page.expect_response(predicate):
+            await page.evaluate("() => fetch('/digits/1.png')")
+
+
+async def test_expect_response_should_reject_when_sync_predicate_throws(
+    page: Page, server: Server
+) -> None:
+    await page.goto(server.EMPTY_PAGE)
+
+    def predicate(response: Any) -> bool:
+        raise Exception("Sync oops!")
+
+    with pytest.raises(Exception, match="Sync oops!"):
+        async with page.expect_response(predicate):
+            await page.evaluate("() => fetch('/digits/1.png')")
+
+
 async def test_wait_for_response_should_work_with_no_timeout(
     page: Page, server: Server
 ) -> None:

From 67e59f5804411f59a5580d0dd7796fd525c59742 Mon Sep 17 00:00:00 2001
From: Dmitry Gozman <dgozman@gmail.com>
Date: Thu, 30 Apr 2026 15:54:11 +0100
Subject: [PATCH 11/13] fix(asyncio): do not deadlock in atexit handler (#3056)

---
 CLAUDE.md                      | 37 ++++++++++++++++++++
 local-requirements.txt         |  1 +
 playwright/_impl/_transport.py | 64 +++++++++++++++++++---------------
 tests/async/test_asyncio.py    | 43 +++++++++++++++++++++++
 4 files changed, 116 insertions(+), 29 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 4153ac4d1..1cbaf3e1a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -59,3 +59,40 @@ It documents the full process: the upstream commit-range diff over `docs/src/api
 - New public methods on impl classes need a sync test mirror under `tests/sync/`.
 - Keep `expected_api_mismatch.txt` minimal — every entry needs a one-line rationale comment above it.
 - Prefer `locals_to_params(locals())` for forwarding optional kwargs to channel sends, matching the rest of the codebase.
+
+## Commit Convention
+
+Before committing, run `mypy playwright` and fix errors.
+
+Semantic commit messages: `label(scope): description`
+
+Labels: `fix`, `feat`, `chore`, `docs`, `test`, `devops`
+
+```bash
+git checkout -b fix-12345
+# ... make changes ...
+git add <changed-files>
+git commit -m "$(cat <<'EOF'
+fix(asyncio): do not deadlock in atexit handler
+
+Fixes: https://github.com/microsoft/playwright-python/issues/12345
+EOF
+)"
+git push origin fix-12345
+gh pr create --repo microsoft/playwright-python --head username:fix-12345 \
+  --title "fix(asyncio): do not deadlock in atexit handler" \
+  --body "$(cat <<'EOF'
+## Summary
+- <describe the change very! briefly>
+
+Fixes https://github.com/microsoft/playwright-python/issues/12345
+EOF
+)"
+```
+
+Never add Co-Authored-By agents in commit message.
+Never add "Generated with" in commit message.
+Never add test plan to PR description. Keep PR description short — a few bullet points at most.
+Branch naming for issue fixes: `fix-<issue-number>`
+
+**Never `git push` without an explicit instruction to push.** Applies even when a PR is already open for the branch — additional commits are immediately visible to reviewers. Commit locally, report what was committed, and wait. Only push when the user's message contains "push", "upload", "create PR", "ship it", or equivalent.
diff --git a/local-requirements.txt b/local-requirements.txt
index 8a72b5745..5735ae2a0 100644
--- a/local-requirements.txt
+++ b/local-requirements.txt
@@ -1,3 +1,4 @@
+asyncio-atexit==1.0.1
 autobahn==23.1.2
 black==25.1.0
 build==1.3.0
diff --git a/playwright/_impl/_transport.py b/playwright/_impl/_transport.py
index 2ca84d459..3cc029e18 100644
--- a/playwright/_impl/_transport.py
+++ b/playwright/_impl/_transport.py
@@ -137,38 +137,44 @@ async def connect(self) -> None:
     async def run(self) -> None:
         assert self._proc.stdout
         assert self._proc.stdin
-        while not self._stopped:
-            try:
-                buffer = await self._proc.stdout.readexactly(4)
-                if self._stopped:
-                    break
-                length = int.from_bytes(buffer, byteorder="little", signed=False)
-                buffer = bytes(0)
-                while length:
-                    to_read = min(length, 32768)
-                    data = await self._proc.stdout.readexactly(to_read)
+        try:
+            while not self._stopped:
+                try:
+                    buffer = await self._proc.stdout.readexactly(4)
+                    if self._stopped:
+                        break
+                    length = int.from_bytes(buffer, byteorder="little", signed=False)
+                    buffer = bytes(0)
+                    while length:
+                        to_read = min(length, 32768)
+                        data = await self._proc.stdout.readexactly(to_read)
+                        if self._stopped:
+                            break
+                        length -= to_read
+                        if len(buffer):
+                            buffer = buffer + data
+                        else:
+                            buffer = data
                     if self._stopped:
                         break
-                    length -= to_read
-                    if len(buffer):
-                        buffer = buffer + data
-                    else:
-                        buffer = data
-                if self._stopped:
-                    break
 
-                obj = self.deserialize_message(buffer)
-                self.on_message(obj)
-            except asyncio.IncompleteReadError:
-                if not self._stopped:
-                    self.on_error_future.set_exception(
-                        Exception("Connection closed while reading from the driver")
-                    )
-                break
-            await asyncio.sleep(0)
-
-        await self._proc.communicate()
-        self._stopped_future.set_result(None)
+                    obj = self.deserialize_message(buffer)
+                    self.on_message(obj)
+                except asyncio.IncompleteReadError:
+                    if not self._stopped:
+                        self.on_error_future.set_exception(
+                            Exception("Connection closed while reading from the driver")
+                        )
+                    break
+                await asyncio.sleep(0)
+
+            await self._proc.communicate()
+        finally:
+            # Release waiters on wait_until_stopped() even if this task was
+            # cancelled before reaching the end (e.g. by asyncio.run()'s
+            # task-cancellation phase that runs before asyncio-atexit hooks).
+            if not self._stopped_future.done():
+                self._stopped_future.set_result(None)
 
     def send(self, message: Dict) -> None:
         assert self._output
diff --git a/tests/async/test_asyncio.py b/tests/async/test_asyncio.py
index 971c65473..c78648430 100644
--- a/tests/async/test_asyncio.py
+++ b/tests/async/test_asyncio.py
@@ -13,7 +13,10 @@
 # limitations under the License.
 import asyncio
 import gc
+import subprocess
 import sys
+import textwrap
+from pathlib import Path
 from typing import Dict
 
 import pytest
@@ -89,6 +92,46 @@ async def raise_exception() -> None:
     assert await page.evaluate("() => 11 * 11") == 121
 
 
+def test_stop_does_not_deadlock_with_asyncio_atexit(tmp_path: Path) -> None:
+    # Regression test for https://github.com/microsoft/playwright-python/issues/3004.
+    # asyncio.run() cancels all remaining tasks (including transport.run()) before
+    # calling loop.close(). asyncio-atexit hooks loop.close() to run async cleanup,
+    # so awaiting playwright.stop() at that point used to deadlock on a future that
+    # the (already cancelled) run task would never set.
+    script = tmp_path / "atexit_stop.py"
+    script.write_text(
+        textwrap.dedent(
+            """
+            import asyncio
+
+            import asyncio_atexit
+            from playwright.async_api import async_playwright
+
+
+            async def main():
+                pw = await async_playwright().start()
+                asyncio_atexit.register(lambda: stop(pw))
+
+
+            async def stop(pw):
+                await pw.stop()
+                print("STOPPED", flush=True)
+
+
+            asyncio.run(main())
+            """
+        )
+    )
+    result = subprocess.run(
+        [sys.executable, str(script)],
+        capture_output=True,
+        text=True,
+        timeout=30,
+    )
+    assert result.returncode == 0, result.stderr
+    assert "STOPPED" in result.stdout
+
+
 async def test_should_return_proper_api_name_on_error(page: Page) -> None:
     try:
         await page.evaluate("does_not_exist")

From f3d8fd19aacae3fc6f44898aa335c25b6f97018a Mon Sep 17 00:00:00 2001
From: Simon Knott <info@simonknott.de>
Date: Thu, 30 Apr 2026 18:27:34 +0200
Subject: [PATCH 12/13] fix: handle ignore_default_args=False in launch params
 (#3058)

Co-authored-by: lp07 <lisa.ppatel26@gmail.com>
---
 playwright/_impl/_browser_type.py | 2 ++
 tests/async/test_launcher.py      | 9 +++++++++
 tests/sync/test_launcher.py       | 7 +++++++
 3 files changed, 18 insertions(+)

diff --git a/playwright/_impl/_browser_type.py b/playwright/_impl/_browser_type.py
index ba376c336..88ea5fc52 100644
--- a/playwright/_impl/_browser_type.py
+++ b/playwright/_impl/_browser_type.py
@@ -357,6 +357,8 @@ def normalize_launch_params(params: Dict) -> None:
         if params["ignoreDefaultArgs"] is True:
             params["ignoreAllDefaultArgs"] = True
             del params["ignoreDefaultArgs"]
+        elif params["ignoreDefaultArgs"] is False:
+            del params["ignoreDefaultArgs"]
     if "executablePath" in params:
         params["executablePath"] = str(Path(params["executablePath"]))
     if "downloadsPath" in params:
diff --git a/tests/async/test_launcher.py b/tests/async/test_launcher.py
index bd5dd82de..2b954fd61 100644
--- a/tests/async/test_launcher.py
+++ b/tests/async/test_launcher.py
@@ -107,3 +107,12 @@ async def test_browser_close_should_be_callable_twice(
         browser.close(),
     )
     await browser.close()
+
+
+async def test_browser_type_launch_should_accept_ignore_default_args_false(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    # Regression for https://github.com/microsoft/playwright-python/issues/3005:
+    # passing False used to crash with "expected array, got boolean".
+    browser = await browser_type.launch(**launch_arguments, ignore_default_args=False)
+    await browser.close()
diff --git a/tests/sync/test_launcher.py b/tests/sync/test_launcher.py
index 2e5ec1573..6b89b79a8 100644
--- a/tests/sync/test_launcher.py
+++ b/tests/sync/test_launcher.py
@@ -88,3 +88,10 @@ def test_browser_close_should_be_callable_twice(
     browser = browser_type.launch(**launch_arguments)
     browser.close()
     browser.close()
+
+
+def test_browser_type_launch_should_accept_ignore_default_args_false(
+    browser_type: BrowserType, launch_arguments: Dict
+) -> None:
+    browser = browser_type.launch(**launch_arguments, ignore_default_args=False)
+    browser.close()

From 86415b64388abbeda9bdd89ade8c4cc2c647cc8f Mon Sep 17 00:00:00 2001
From: Dmitry Gozman <dgozman@gmail.com>
Date: Thu, 30 Apr 2026 22:25:54 +0100
Subject: [PATCH 13/13] fix(typing): typed overloads for expect_event and
 wait_for_event (#3061)

---
 playwright/async_api/_generated.py         | 729 ++++++++++++++++++++-
 playwright/sync_api/_generated.py          | 729 ++++++++++++++++++++-
 scripts/documentation_provider.py          |  49 ++
 scripts/generate_async_api.py              |   2 +
 scripts/generate_sync_api.py               |   2 +
 tests/async/test_browsercontext_events.py  |   2 +-
 tests/async/test_page_request_intercept.py |   3 +-
 tests/async/test_resource_timing.py        |   5 +-
 tests/sync/test_resource_timing.py         |   6 +-
 9 files changed, 1489 insertions(+), 38 deletions(-)

diff --git a/playwright/async_api/_generated.py b/playwright/async_api/_generated.py
index 130230390..9e8737c12 100644
--- a/playwright/async_api/_generated.py
+++ b/playwright/async_api/_generated.py
@@ -1120,6 +1120,55 @@ def url(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.url)
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["WebSocket"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framereceived"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["typing.Union[bytes, str]"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framesent"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["typing.Union[bytes, str]"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["socketerror"],
+        predicate: typing.Optional[typing.Callable[["str"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["str"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -1153,6 +1202,55 @@ def expect_event(
             ).future
         )
 
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebSocket": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["framereceived"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "typing.Union[bytes, str]": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["framesent"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "typing.Union[bytes, str]": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["socketerror"],
+        predicate: typing.Optional[typing.Callable[["str"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "str": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     async def wait_for_event(
         self,
         event: str,
@@ -6737,6 +6835,33 @@ async def evaluate_handle(
             )
         )
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["ConsoleMessage"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -9531,6 +9656,186 @@ async def wait_for_url(
             )
         )
 
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "ConsoleMessage": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["crash"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Dialog": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["domcontentloaded"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["download"],
+        predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Download": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["filechooser"],
+        predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "FileChooser": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["frameattached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["framedetached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["framenavigated"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["load"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["pageerror"],
+        predicate: typing.Optional[typing.Callable[["Error"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Error": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["popup"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Response": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["websocket"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebSocket": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["worker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Worker": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     async def wait_for_event(
         self,
         event: str,
@@ -12074,28 +12379,208 @@ async def pdf(
             )
         )
 
+    @typing.overload
     def expect_event(
         self,
-        event: str,
-        predicate: typing.Optional[typing.Callable] = None,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
         timeout: typing.Optional[float] = None,
-    ) -> AsyncEventContextManager:
-        """Page.expect_event
+    ) -> AsyncEventContextManager["Page"]: ...
 
-        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
-        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["ConsoleMessage"]: ...
 
-        **Usage**
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["crash"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
 
-        ```py
-        async with page.expect_event(\"framenavigated\") as event_info:
-            await page.get_by_role(\"button\")
-        frame = await event_info.value
-        ```
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Dialog"]: ...
 
-        Parameters
-        ----------
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["domcontentloaded"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["download"],
+        predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Download"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["filechooser"],
+        predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["FileChooser"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["frameattached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framedetached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framenavigated"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["load"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["pageerror"],
+        predicate: typing.Optional[typing.Callable[["Error"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Error"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["popup"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Response"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["websocket"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["WebSocket"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["worker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager[typing.Any]: ...
+
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager:
+        """Page.expect_event
+
+        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
+        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+
+        **Usage**
+
+        ```py
+        async with page.expect_event(\"framenavigated\") as event_info:
+            await page.get_by_role(\"button\")
+        frame = await event_info.value
+        ```
+
+        Parameters
+        ----------
         event : str
             Event name, same one typically passed into `*.on(event)`.
         predicate : Union[Callable, None]
@@ -13964,6 +14449,114 @@ async def route_from_har(
             )
         )
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["backgroundpage"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["BrowserContext"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["BrowserContext"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["ConsoleMessage"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Dialog"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["page"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["weberror"],
+        predicate: typing.Optional[typing.Callable[["WebError"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["WebError"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Response"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["serviceworker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> AsyncEventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -14089,6 +14682,114 @@ async def set_storage_state(
             await self._impl_obj.set_storage_state(storageState=storage_state)
         )
 
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["backgroundpage"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["BrowserContext"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "BrowserContext": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "ConsoleMessage": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Dialog": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["page"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["weberror"],
+        predicate: typing.Optional[typing.Callable[["WebError"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebError": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Response": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: typing.Literal["serviceworker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Worker": ...
+
+    @typing.overload
+    async def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     async def wait_for_event(
         self,
         event: str,
diff --git a/playwright/sync_api/_generated.py b/playwright/sync_api/_generated.py
index f7a8a2c24..13139abec 100644
--- a/playwright/sync_api/_generated.py
+++ b/playwright/sync_api/_generated.py
@@ -1112,6 +1112,55 @@ def url(self) -> str:
         """
         return mapping.from_maybe_impl(self._impl_obj.url)
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["WebSocket"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framereceived"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["typing.Union[bytes, str]"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framesent"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["typing.Union[bytes, str]"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["socketerror"],
+        predicate: typing.Optional[typing.Callable[["str"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["str"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -1145,6 +1194,55 @@ def expect_event(
             ).future,
         )
 
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebSocket": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["framereceived"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "typing.Union[bytes, str]": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["framesent"],
+        predicate: typing.Optional[
+            typing.Callable[["typing.Union[bytes, str]"], bool]
+        ] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "typing.Union[bytes, str]": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["socketerror"],
+        predicate: typing.Optional[typing.Callable[["str"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "str": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     def wait_for_event(
         self,
         event: str,
@@ -6825,6 +6923,33 @@ def evaluate_handle(
             )
         )
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["ConsoleMessage"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -9532,6 +9657,186 @@ def wait_for_url(
             )
         )
 
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "ConsoleMessage": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["crash"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Dialog": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["domcontentloaded"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["download"],
+        predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Download": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["filechooser"],
+        predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "FileChooser": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["frameattached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["framedetached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["framenavigated"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Frame": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["load"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["pageerror"],
+        predicate: typing.Optional[typing.Callable[["Error"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Error": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["popup"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Response": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["websocket"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebSocket": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["worker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Worker": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     def wait_for_event(
         self,
         event: str,
@@ -12130,28 +12435,208 @@ def pdf(
             )
         )
 
+    @typing.overload
     def expect_event(
         self,
-        event: str,
-        predicate: typing.Optional[typing.Callable] = None,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
         *,
         timeout: typing.Optional[float] = None,
-    ) -> EventContextManager:
-        """Page.expect_event
+    ) -> EventContextManager["Page"]: ...
 
-        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
-        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["ConsoleMessage"]: ...
 
-        **Usage**
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["crash"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
 
-        ```py
-        with page.expect_event(\"framenavigated\") as event_info:
-            page.get_by_role(\"button\")
-        frame = event_info.value
-        ```
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Dialog"]: ...
 
-        Parameters
-        ----------
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["domcontentloaded"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["download"],
+        predicate: typing.Optional[typing.Callable[["Download"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Download"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["filechooser"],
+        predicate: typing.Optional[typing.Callable[["FileChooser"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["FileChooser"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["frameattached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framedetached"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["framenavigated"],
+        predicate: typing.Optional[typing.Callable[["Frame"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Frame"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["load"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["pageerror"],
+        predicate: typing.Optional[typing.Callable[["Error"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Error"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["popup"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Response"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["websocket"],
+        predicate: typing.Optional[typing.Callable[["WebSocket"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["WebSocket"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["worker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager[typing.Any]: ...
+
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager:
+        """Page.expect_event
+
+        Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy
+        value. Will throw an error if the page is closed before the event is fired. Returns the event data value.
+
+        **Usage**
+
+        ```py
+        with page.expect_event(\"framenavigated\") as event_info:
+            page.get_by_role(\"button\")
+        frame = event_info.value
+        ```
+
+        Parameters
+        ----------
         event : str
             Event name, same one typically passed into `*.on(event)`.
         predicate : Union[Callable, None]
@@ -13967,6 +14452,114 @@ def route_from_har(
             )
         )
 
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["backgroundpage"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["BrowserContext"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["BrowserContext"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["ConsoleMessage"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Dialog"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["page"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Page"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["weberror"],
+        predicate: typing.Optional[typing.Callable[["WebError"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["WebError"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Request"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Response"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: typing.Literal["serviceworker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager["Worker"]: ...
+
+    @typing.overload
+    def expect_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> EventContextManager[typing.Any]: ...
+
     def expect_event(
         self,
         event: str,
@@ -14092,6 +14685,114 @@ def set_storage_state(
             self._sync(self._impl_obj.set_storage_state(storageState=storage_state))
         )
 
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["backgroundpage"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["close"],
+        predicate: typing.Optional[typing.Callable[["BrowserContext"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "BrowserContext": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["console"],
+        predicate: typing.Optional[typing.Callable[["ConsoleMessage"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "ConsoleMessage": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["dialog"],
+        predicate: typing.Optional[typing.Callable[["Dialog"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Dialog": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["page"],
+        predicate: typing.Optional[typing.Callable[["Page"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Page": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["weberror"],
+        predicate: typing.Optional[typing.Callable[["WebError"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "WebError": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["request"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["requestfailed"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["requestfinished"],
+        predicate: typing.Optional[typing.Callable[["Request"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Request": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["response"],
+        predicate: typing.Optional[typing.Callable[["Response"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Response": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: typing.Literal["serviceworker"],
+        predicate: typing.Optional[typing.Callable[["Worker"], bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> "Worker": ...
+
+    @typing.overload
+    def wait_for_event(
+        self,
+        event: str,
+        predicate: typing.Optional[typing.Callable[..., bool]] = None,
+        *,
+        timeout: typing.Optional[float] = None,
+    ) -> typing.Any: ...
+
     def wait_for_event(
         self,
         event: str,
diff --git a/scripts/documentation_provider.py b/scripts/documentation_provider.py
index 4c2d9b95d..e3f1f1ebd 100644
--- a/scripts/documentation_provider.py
+++ b/scripts/documentation_provider.py
@@ -243,6 +243,55 @@ def print_events(self, class_name: str) -> None:
                 doc.append(f"        return super().{event_type}(event=event,f=f)")
             print("\n".join(doc))
 
+    def print_event_overloads(self, class_name: str, method_name: str) -> None:
+        """Emit ``@typing.overload`` stubs for ``expect_event`` / ``wait_for_event``
+        keyed on ``Literal`` event names with their payload types from api.json,
+        so pyright/mypy can narrow the return type at call sites.
+        Must be called right before the implementation signature is emitted.
+        """
+        if class_name not in self.classes:
+            return
+        events = self.classes[class_name].get("events") or []
+        if not events:
+            return
+        is_expect = method_name == "expect_event"
+        async_prefix = "async " if not is_expect and self.is_async else ""
+        if is_expect:
+            ctx_mgr = (
+                "AsyncEventContextManager" if self.is_async else "EventContextManager"
+            )
+        for event in events:
+            payload = self.serialize_doc_type(event["type"], "")
+            if payload.startswith("{"):
+                payload = "typing.Dict"
+            if "Union[" in payload:
+                payload = payload.replace("Union[", "typing.Union[")
+            return_type = f'{ctx_mgr}["{payload}"]' if is_expect else f'"{payload}"'
+            event_literal = event["name"].lower()
+            print("    @typing.overload")
+            print(f"    {async_prefix}def {method_name}(")
+            print("        self,")
+            print(f'        event: typing.Literal["{event_literal}"],')
+            print(
+                f'        predicate: typing.Optional[typing.Callable[["{payload}"], bool]] = None,'
+            )
+            print("        *,")
+            print("        timeout: typing.Optional[float] = None,")
+            print(f"    ) -> {return_type}: ...")
+            print("")
+        # Catch-all overload for non-literal event names — keeps pyright happy
+        # with `event: str` callers without falling through to `Unknown`.
+        catchall_return = f"{ctx_mgr}[typing.Any]" if is_expect else "typing.Any"
+        print("    @typing.overload")
+        print(f"    {async_prefix}def {method_name}(")
+        print("        self,")
+        print("        event: str,")
+        print("        predicate: typing.Optional[typing.Callable[..., bool]] = None,")
+        print("        *,")
+        print("        timeout: typing.Optional[float] = None,")
+        print(f"    ) -> {catchall_return}: ...")
+        print("")
+
     def indent_paragraph(self, p: str, indent: str) -> str:
         lines = p.split("\n")
         result = [lines[0]]
diff --git a/scripts/generate_async_api.py b/scripts/generate_async_api.py
index 4c0b4b655..e844bc400 100755
--- a/scripts/generate_async_api.py
+++ b/scripts/generate_async_api.py
@@ -92,6 +92,8 @@ def generate(t: Any) -> None:
                 '"Disposable"', '"AsyncContextManager"'
             ).replace('"DisposableStub"', '"AsyncContextManager"')
             print("")
+            if name in ("expect_event", "wait_for_event"):
+                documentation_provider.print_event_overloads(class_name, name)
             async_prefix = "async " if is_async else ""
             print(
                 f"    {async_prefix}def {name}({signature(value, len(name) + 9)}) -> {return_type_value}:"
diff --git a/scripts/generate_sync_api.py b/scripts/generate_sync_api.py
index dbabce413..fa6ac8702 100755
--- a/scripts/generate_sync_api.py
+++ b/scripts/generate_sync_api.py
@@ -93,6 +93,8 @@ def generate(t: Any) -> None:
                 '"Disposable"', '"SyncContextManager"'
             ).replace('"DisposableStub"', '"SyncContextManager"')
             print("")
+            if name in ("expect_event", "wait_for_event"):
+                documentation_provider.print_event_overloads(class_name, name)
             print(
                 f"    def {name}({signature(value, len(name) + 9)}) -> {return_type_value}:"
             )
diff --git a/tests/async/test_browsercontext_events.py b/tests/async/test_browsercontext_events.py
index 8ae14def6..cfe585c77 100644
--- a/tests/async/test_browsercontext_events.py
+++ b/tests/async/test_browsercontext_events.py
@@ -197,7 +197,7 @@ async def test_page_error_event_should_work(page: Page) -> None:
         await page.set_content('<script>throw new Error("boom")</script>')
     page_error = await page_error_info.value
     assert page_error.page == page
-    assert "boom" in page_error.error.stack
+    assert page_error.error.stack and "boom" in page_error.error.stack
 
 
 async def test_weberror_event_should_work(context: BrowserContext, page: Page) -> None:
diff --git a/tests/async/test_page_request_intercept.py b/tests/async/test_page_request_intercept.py
index a9859e87b..d294031d5 100644
--- a/tests/async/test_page_request_intercept.py
+++ b/tests/async/test_page_request_intercept.py
@@ -13,7 +13,6 @@
 # limitations under the License.
 
 import asyncio
-from typing import cast
 
 import pytest
 
@@ -98,4 +97,4 @@ async def route_handler(route: Route) -> None:
     [popup, _] = await asyncio.gather(
         page.wait_for_event("popup"), page.get_by_text("click me").click()
     )
-    await expect(cast(Page, popup).locator("body")).to_have_text("hello")
+    await expect(popup.locator("body")).to_have_text("hello")
diff --git a/tests/async/test_resource_timing.py b/tests/async/test_resource_timing.py
index a8481b8c8..e764e3159 100644
--- a/tests/async/test_resource_timing.py
+++ b/tests/async/test_resource_timing.py
@@ -12,11 +12,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Dict
 
 import pytest
 
-from playwright.async_api import Browser, Page
+from playwright.async_api import Browser, Page, ResourceTiming
 from tests.server import Server
 
 
@@ -95,7 +94,7 @@ def verify_timing_value(value: float, previous: float) -> None:
     assert value == -1 or value > 0 and value >= previous
 
 
-def verify_connections_timing_consistency(timing: Dict) -> None:
+def verify_connections_timing_consistency(timing: ResourceTiming) -> None:
     verify_timing_value(timing["domainLookupStart"], -1)
     verify_timing_value(timing["domainLookupEnd"], timing["domainLookupStart"])
     verify_timing_value(timing["connectStart"], timing["domainLookupEnd"])
diff --git a/tests/sync/test_resource_timing.py b/tests/sync/test_resource_timing.py
index a5bd8dd8a..1c6efab6a 100644
--- a/tests/sync/test_resource_timing.py
+++ b/tests/sync/test_resource_timing.py
@@ -12,11 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-from typing import Dict
-
 import pytest
 
-from playwright.sync_api import Browser, Page
+from playwright.sync_api import Browser, Page, ResourceTiming
 from tests.server import Server
 
 
@@ -99,7 +97,7 @@ def verify_timing_value(value: float, previous: float) -> None:
     assert value == -1 or value > 0 and value >= previous
 
 
-def verify_connections_timing_consistency(timing: Dict) -> None:
+def verify_connections_timing_consistency(timing: ResourceTiming) -> None:
     verify_timing_value(timing["domainLookupStart"], -1)
     verify_timing_value(timing["domainLookupEnd"], timing["domainLookupStart"])
     verify_timing_value(timing["connectStart"], timing["domainLookupEnd"])